DataConnectionProperties 類別

支援包含資料連接屬性的連接字串格式化和剖析文化特性，以及為強型別屬性儲存區、自訂屬性和同義資料表。

繼承階層架構

Object
  Microsoft.VisualStudio.Data.Framework.DataConnectionProperties

命名空間：  Microsoft.VisualStudio.Data.Framework
組件：  Microsoft.VisualStudio.Data.Framework (在 Microsoft.VisualStudio.Data.Framework.dll 中)

語法

'宣告
Public MustInherit Class DataConnectionProperties _
    Implements IVsDataConnectionProperties, IDictionary(Of String, Object),  _
    ICollection(Of KeyValuePair(Of String, Object)), IEnumerable(Of KeyValuePair(Of String, Object)),  _
    IEnumerable, IVsDataConnectionUIProperties, ICustomTypeDescriptor, INotifyPropertyChanged

public abstract class DataConnectionProperties : IVsDataConnectionProperties, 
    IDictionary<string, Object>, ICollection<KeyValuePair<string, Object>>, 
    IEnumerable<KeyValuePair<string, Object>>, IEnumerable, IVsDataConnectionUIProperties, 
    ICustomTypeDescriptor, INotifyPropertyChanged

public ref class DataConnectionProperties abstract : IVsDataConnectionProperties, 
    IDictionary<String^, Object^>, ICollection<KeyValuePair<String^, Object^>>, 
    IEnumerable<KeyValuePair<String^, Object^>>, IEnumerable, 
    IVsDataConnectionUIProperties, ICustomTypeDescriptor, INotifyPropertyChanged

[<AbstractClass>]
type DataConnectionProperties =  
    class 
        interface IVsDataConnectionProperties 
        interface IDictionary<string, Object>
        interface ICollection<KeyValuePair<string, Object>>
        interface IEnumerable<KeyValuePair<string, Object>>
        interface IEnumerable 
        interface IVsDataConnectionUIProperties 
        interface ICustomTypeDescriptor 
        interface INotifyPropertyChanged 
    end

public abstract class DataConnectionProperties implements IVsDataConnectionProperties, IDictionary<String, Object>, ICollection<KeyValuePair<String, Object>>, IEnumerable<KeyValuePair<String, Object>>, IEnumerable, IVsDataConnectionUIProperties, ICustomTypeDescriptor, INotifyPropertyChanged

DataConnectionProperties 類型會公開下列成員。

建構函式

	名稱	描述
	DataConnectionProperties()	初始化 DataConnectionProperties 類別的非參數化的執行個體。
	DataConnectionProperties(IEqualityComparer<String>)	初始化提供比較屬性名稱初始化 DataConnectionProperties 類別的新參數型的執行個體。
	DataConnectionProperties(IEqualityComparer<String>, Char, Char)	初始化提供比較屬性名稱初始化 DataConnectionProperties 類別的新參數型的執行個體。

回頁首

屬性

	名稱	描述
	Count	取得現有資料連接屬性的數目。
	IsComplete	取得表示特定連接字串值的 Boolean 值是完整的。
	IsExtensible	取得或設定值 DDEX 提供者連接屬性值的 Boolean 值是可擴充的。
	Item	取得或設定 DDEX 提供者的指定屬性的值。
	Keys	取得目前的屬性索引鍵名稱的集合。
	OrderedProperties	取得的屬性名稱集合指定合理 (或命令) 命令的屬性設定為，表示當以字串形式。
	Values	擷取目前屬性值的集合。

回頁首

方法

	名稱	描述
	Add(String, Object)	將新屬性加入至目前連接屬性集合。
	Add(String, Type, Object)	將新屬性加入至目前連接屬性集合。
	AddProperty(PropertyDescriptor, array<Attribute[])	動態地將新屬性加入至 DataConnectionProperties 類別目前的執行個體原本辨識屬性的集合。
	AddProperty(String, Type, array<Attribute[])	動態地將新屬性加入至這個資料連接屬性執行個體原本辨識屬性的集合。
	Contains	測試指定的屬性及其值是否存在於目前的連接屬性。
	ContainsKey	測試指定的屬性是否為目前的成員來設定連接屬性。
	CopyTo	複製目前設定連接屬性及其值的指定陣列，開始於指定的陣列索引。
	Equals	判斷指定的物件是否等於目前的物件。 (繼承自 Object)。
	Finalize	在記憶體回收開始前，允許物件嘗試釋放資源，並執行其他清除作業。 (繼承自 Object)。
	GetHashCode	做為預設雜湊函式。 (繼承自 Object)。
	GetKeyAsString	將格式的屬性索引鍵在連接字串。
	GetProperties()	擷取目前所有已知的屬性描述元集合。
	GetProperties(array<Attribute[])	擷取目前已知的屬性描述元集合符合指定的屬性集。
	GetProperty	要擷取其屬性的描述項與指定之屬性名稱的。
	GetSynonyms	擷取同義資料表陣列清單中指定的屬性。
	GetType	取得目前實例 Type 的屬性。 (繼承自 Object)。
	GetValueAsString	將格式的屬性值在連接字串。
	Initialize	初始化目前的 DataConnectionProperties 執行個體初始化為預設狀態，然後在指定字典中的每個屬性。
	InitializeProperties	使用一組目前 DataConnectionProperties 執行個體的原本即已辨識屬性。
	InitializeSynonyms	初始化組同義資料表可供每個原本所識別的目前 DataConnectionProperties 執行個體的屬性。
	InitializeValue	初始化一個具有指定之屬性的值。
	InitializeValues	一組指定初始化屬性的值，請使用名稱/值組的字典。
	IsSensitive	指示屬性是否包含敏感資訊。
	MemberwiseClone	建立目前 Object 的淺層複製 (Shallow Copy) 。 (繼承自 Object)。
	ModifyProperty	修改目前的 DataConnectionProperties 執行個體原本就知道現有的屬性。
	OnPropertyChanged	引發 PropertyChanged 事件。
	Parse	反組譯碼連接字串的元件至一組在目前 DataConnectionProperties 執行個體的屬性。
	ReadKeyFromString	會從指定的索引開始的連接字串的屬性機碼名稱，然後更新索引指向屬性索引鍵名稱之後的位置。
	ReadValueFromString	會從指定的索引開始的連接字串的屬性值，將它轉換為正確的型別，並更新索引指向遵循屬性名稱的位置。
	Remove	從目前連接屬性集合移除屬性。
	RemoveProperty	從屬性的目前集合移除原本即已辨識屬性。
	Reset()	重設連接屬性的值為初始狀態。
	Reset(String)	從目前移除指定的屬性設定資料連接屬性。
	ResolveProperty	如果不這樣做，已經搜尋在同義資料表清單中指定的屬性和選擇性地將這個屬性主要名稱同義資料表集合。
	SetPropertySynonyms	設定或清除指定之屬性的同義資料表。
	ShouldPersistProperty	指示是否應該保存屬性，當建立連接字串時。
	ToDisplayString	擷取目前的字串表示設定適用於螢幕上顯示的資料連接屬性。
	ToSafeString	擷取排除敏感性屬性或屬性不應該保存目前的字串表示設定資料連接屬性。
	ToString	擷取目前連接屬性的預設字串表示。 (覆寫 Object.ToString。)
	TryGetValue	擷取指定之屬性的值。

回頁首

事件

	名稱	描述
	PropertyChanged	在變更的事件會連接屬性的。

回頁首

明確介面實作

	名稱	描述
	ICollection<KeyValuePair<String, Object>>.Add	加入項目做為索引鍵/值組加入目前設定連接屬性。
	ICollection<KeyValuePair<String, Object>>.Clear	從目前移除所有項目設定連接屬性。
	ICustomTypeDescriptor.GetAttributes	擷取自訂屬性的集合中指定之物件的。
	ICustomTypeDescriptor.GetClassName	擷取指定之物件的類別名稱。
	ICustomTypeDescriptor.GetComponentName	擷取指定之物件的名稱。
	ICustomTypeDescriptor.GetConverter	擷取指定之物件的型別轉換子。
	ICustomTypeDescriptor.GetDefaultEvent	擷取指定之物件的預設事件。
	ICustomTypeDescriptor.GetDefaultProperty	擷取指定之物件的預設屬性。
	ICustomTypeDescriptor.GetEditor	擷取指定型別的編輯器這個物件的。
	IEnumerable<KeyValuePair<String, Object>>.GetEnumerator	擷取 KeyValuePair的 IEnumerator 。
	IEnumerable.GetEnumerator	擷取 IEnumerator。
	ICustomTypeDescriptor.GetEvents()	擷取元件的指定執行個體的事件。
	ICustomTypeDescriptor.GetEvents(array<Attribute[])	擷取這個元件執行個體的事件，使用指定的屬性陣列做為篩選條件。
	ICustomTypeDescriptor.GetProperties()	擷取元件的指定執行個體的屬性。
	ICustomTypeDescriptor.GetProperties(array<Attribute[])	擷取元件的指定執行個體的屬性，使用屬性陣列做為篩選條件。
	ICustomTypeDescriptor.GetPropertyOwner	擷取物件的屬性所指定的屬性描述項所描述的。
	ICollection<KeyValuePair<String, Object>>.IsReadOnly	取得指出目前的 ICollection 執行個體的 Boolean 是否為唯讀。
	ICollection<KeyValuePair<String, Object>>.Remove	從目前移除指定的屬性設定連接屬性。

回頁首

備註

最簡單的情況下，衍生類別在這些屬性應該將屬性設定為其類別並將元件屬性自訂其行為。 在進階案例，衍生類別可以覆寫剖析及格式化程式碼和動態變更根據特定動作的任何屬性，例如設定屬性的值。

執行緒安全

這個類型的任何 Public static (在 Visual Basic 中為 Shared) 成員都是安全執行緒。不保證任何執行個體成員是安全執行緒。

請參閱

參考

Microsoft.VisualStudio.Data.Framework 命名空間