發行項
09/24/2010

通用屬性

MicrosoftSQL ServerIntegration Services 物件模型中的資料流程物件具有元件層級、輸入和輸出層級，以及輸入資料行和輸出資料行層級上的通用屬性和自訂屬性。許多屬性都有唯讀的值，這些值是在執行階段由資料流程引擎所指派。

本主題將列出及描述資料流程物件的通用屬性。

元件
輸入
輸入資料行
輸出
輸出資料行

元件屬性

在 Integration Services 物件模型中，資料流程中的元件會實作 IDTSComponentMetaData100 介面。

下表將描述資料流程中的元件屬性。某些屬性具有唯讀的值，這些值是在執行階段由資料流程引擎所指派。

屬性	資料類型	描述
ComponentClassID	字串	元件的 CLSID。
ContactInfo	字串	元件開發人員的連絡資訊。
Description	字串	資料流程元件的描述。這個屬性的預設值為資料流程元件的名稱。
ID	整數	可唯一識別這個元件執行個體的值。
IdentificationString	字串	識別此元件。
IsDefaultLocale	布林	指示元件是否使用其所屬之資料流程工作的地區設定。
LocaleID	整數	當封裝執行時，資料流程元件所使用的地區設定。所有的 Windows 地區設定都可用於資料流程元件。
Name	字串	資料流程元件的名稱。
PipelineVersion	整數	專門用來執行元件的資料流程工作版本。
UsesDispositions	布林	指示元件是否有錯誤輸出。
ValidateExternalMetadata	布林	指示是否會驗證外部資料行的中繼資料。此屬性的預設值為 True。
Version	整數	元件的版本。

輸入屬性

在 Integration Services 物件模型中，轉換和目的地都有輸入。資料流程中元件的輸入會實作 IDTSInput100 介面。

下表將描述資料流程中元件輸入的屬性。某些屬性具有唯讀的值，這些值是在執行階段由資料流程引擎所指派。

屬性	資料類型	描述
Description	字串	輸入的描述。
ErrorOrTruncationOperation	字串	指定處理資料列時發生之錯誤或截斷類型的選擇性字串。
ErrorRowDisposition	DTSRowDisposition	指定錯誤處理的值。這些值為 Fail component、Ignore failure 和 Redirect row。
HasSideEffects	布林	指示當元件未附加到下游元件以及當 RunInOptimizedMode 為 true 時，是否可以從資料流程的執行計畫中移除此元件。
ID	整數	可唯一識別輸入的值。
IdentificationString	字串	識別輸入的字串。
IsSorted	布林	指示是否要排序輸入中的資料。
Name	字串	輸入的名稱。
SourceLocale	整數	輸入資料的地區設定識別碼 (LCID)。
TruncationRowDisposition	DTSRowDisposition	決定元件如何處理當處理資料列時發生之截斷的值。. 這些值為 Fail component、Ignore failure 和 Redirect row。

目的地和某些轉換不支援錯誤輸出，而且這些元件的 ErrorRowDisposition 和 TruncationRowDisposition 屬性是唯讀的。

輸入資料行屬性

在 Integration Services 物件模型中，輸入包含輸入資料行的集合。資料流程中元件的輸入資料行會實作 IDTSInputColumn100 介面。

下表將描述資料流程中元件輸入資料行的屬性。某些屬性具有唯讀的值，這些值是在執行階段由資料流程引擎所指派。

屬性	資料類型	描述
ComparisonFlags	整數	指定具有字元資料類型之資料行比較的一組旗標。如需詳細資訊，請參閱＜比較字串資料＞。
Description	字串	描述輸入資料行。
ErrorOrTruncationOperation	字串	指定處理資料列時發生之錯誤或截斷類型的選擇性字串。
ErrorRowDisposition	DTSRowDisposition	指定錯誤處理的值。這些值為 Fail component、Ignore failure 和 Redirect row。
ExternalMetadataColumnID	IDTSExternalMetadataColumn100	指派給輸入資料行之外部中繼資料行的識別碼。
ID	整數	可唯一識別輸入資料行的值。
IdentificationString	字串	識別輸入資料行的字串。
LineageID	整數	上游資料行的識別碼。
Name	字串	輸入資料行的名稱。
SortKeyPosition	整數	指示是否排序資料行、其排序次序以及排序多個資料行之順序的值。值為 0 時，表示資料行並未排序。如需詳細資訊，請參閱＜如何：排序合併和合併聯結轉換的資料＞。
TruncationRowDisposition	DTSRowDisposition	決定元件如何處理當處理資料列時發生之截斷的值。這些值為 Fail component、Ignore failure 和 Redirect row。
UpstreamComponentName	字串	上游元件的名稱。
UsageType	DTSUsageType	決定元件如何使用輸入資料行的值。

輸入資料行也具有資料類型屬性 (如「資料類型屬性」底下所述)。

輸出屬性

在 Integration Services 物件模型中，來源和轉換都有輸出。資料流程中元件的輸出會實作 IDTSOutput100 介面。

下表將描述資料流程中元件輸出的屬性。某些屬性具有唯讀的值，這些值是在執行階段由資料流程引擎所指派。

屬性	資料類型	描述
DeleteOutputOnPathDetached	布林	決定當從路徑中卸離輸出時，資料流程引擎是否要刪除輸出的值。
Description	字串	描述輸出。
ErrorOrTruncationOperation	字串	指定處理資料列時發生之錯誤或截斷類型的選擇性字串。
ErrorRowDisposition	DTSRowDisposition	指定錯誤處理的值。這些值為 Fail component、Ignore failure 和 Redirect row。
ExclusionGroup	整數	識別一組互斥輸出的值。
HasSideEffects	布林	指示當元件未附加到上游元件以及當 RunInOptimizedMode 為 true 時，是否可以從資料流程的執行計畫中移除此元件的值。
ID	整數	可唯一識別輸出的值。
IdentificationString	字串	識別輸出的字串。
IsErrorOut	布林	指示輸出是否為錯誤輸出。
IsSorted	布林	指示是否要排序輸出。預設值為 False。重要事項將 IsSorted 屬性的值設定為 True 時，不會排序資料。此屬性僅針對資料先前已經過排序的下游元件提供提示。如需詳細資訊，請參閱＜如何：排序合併和合併聯結轉換的資料＞。
Name	字串	輸出的名稱。
SynchronousInputID	整數	與輸出同步之輸入的識別碼。
TruncationRowDisposition	DTSRowDisposition	決定元件如何處理當處理資料列時發生之截斷的值。這些值為 Fail component、Ignore failure 和 Redirect row。

輸出資料行屬性

在 Integration Services 物件模型中，輸出包含輸出資料行的集合。資料流程中元件的輸出資料行會實作 IDTSOutputColumn100 介面。

下表將描述資料流程中元件輸出資料行的屬性。某些屬性具有唯讀的值，這些值是在執行階段由資料流程引擎所指派。

屬性	資料類型	描述
ComparisonFlags	整數	指定具有字元資料類型之資料行比較的一組旗標。如需詳細資訊，請參閱＜比較字串資料＞。
Description	字串	描述輸出資料行。
ErrorOrTruncationOperation	字串	指定處理資料列時發生之錯誤或截斷類型的選擇性字串。
ErrorRowDisposition	DTSRowDisposition	指定錯誤處理的值。這些值為 Fail component、Ignore failure 和 Redirect row。預設值為 Fail component。
ExternalMetadataColumnID	整數	指派給輸入資料行之外部中繼資料行的識別碼。
ID	整數	可唯一識別輸出資料行的值。
IdentificationString	字串	識別輸出資料行的字串。
LineageID	整數	輸出資料行的識別碼。下游元件會使用這個值來參考此資料行。
Name	字串	輸出資料行的名稱。
SortKeyPosition	整數	指示是否排序資料行、其排序次序以及排序多個資料行之順序的值。當這個值為 0 時，表示資料行並未排序。如需詳細資訊，請參閱＜如何：排序合併和合併聯結轉換的資料＞。
SpecialFlags	整數	包含輸出資料行之特殊旗標的值。
TruncationRowDisposition	DTSRowDisposition	決定元件如何處理當處理資料列時發生之截斷的值。這些值為 Fail component、Ignore failure 和 Redirect row。預設值為 Fail component。

輸出資料行也包含一組資料類型屬性。

外部中繼資料行屬性

在 Integration Services 物件模型中，輸入和輸出都可以包含外部中繼資料行的集合。資料流程中元件的外部中繼資料行會實作 IDTSExternalMetadataColumn100 介面。

下表將描述資料流程中元件之外部中繼資料行的屬性。某些屬性具有唯讀的值，這些值是在執行階段由資料流程引擎所指派。

屬性	資料類型	描述
Description	字串	描述外部資料行。
ID	整數	可唯一識別此資料行的值。
IdentificationString	字串	識別此資料行的字串。
Name	字串	外部資料行的名稱。

外部中繼資料行也包含一組資料類型屬性。

資料類型屬性

輸出資料行和外部中繼資料行也包含一組資料類型屬性。根據此資料行的資料類型而定，屬性可以是可讀寫或唯讀。

下表將描述輸出資料行和外部中繼資料行的資料類型屬性。

屬性	資料類型	描述
CodePage	整數	指定字串資料的字碼頁不是 Unicode。
DataType	整數 (列舉)	此資料行的 Integration Services 資料類型。如需詳細資訊，請參閱＜Integration Services 資料類型＞。
Length	整數	資料行的長度 (以字元為測量單位)。
Precision	整數	數值資料行的有效位數。
Scale	整數	數值資料行的小數位數。