EntityConnectionStringBuilder Klasa

Definicja

Przestrzeń nazw:: System.Data.EntityClient

Zestaw:: System.Data.Entity.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Zapewnia prosty sposób tworzenia zawartości parametrów połączenia używanych przez obiekt EntityClient i zarządzania nimi.

public ref class EntityConnectionStringBuilder sealed : System::Data::Common::DbConnectionStringBuilder

public sealed class EntityConnectionStringBuilder : System.Data.Common.DbConnectionStringBuilder

type EntityConnectionStringBuilder = class
    inherit DbConnectionStringBuilder

Public NotInheritable Class EntityConnectionStringBuilder
Inherits DbConnectionStringBuilder

Dziedziczenie: Object

DbConnectionStringBuilder
EntityConnectionStringBuilder

Przykłady

W poniższym przykładzie pokazano, jak używać funkcji EntityConnectionStringBuilder w połączeniu z elementem SqlConnectionStringBuilder.


// Specify the provider name, server and database.
string providerName = "System.Data.SqlClient";
string serverName = ".";
string databaseName = "AdventureWorks";

// Initialize the connection string builder for the
// underlying provider.
SqlConnectionStringBuilder sqlBuilder =
    new SqlConnectionStringBuilder();

// Set the properties for the data source.
sqlBuilder.DataSource = serverName;
sqlBuilder.InitialCatalog = databaseName;
sqlBuilder.IntegratedSecurity = true;

// Build the SqlConnection connection string.
string providerString = sqlBuilder.ToString();

// Initialize the EntityConnectionStringBuilder.
EntityConnectionStringBuilder entityBuilder =
    new EntityConnectionStringBuilder();

//Set the provider name.
entityBuilder.Provider = providerName;

// Set the provider-specific connection string.
entityBuilder.ProviderConnectionString = providerString;

// Set the Metadata location.
entityBuilder.Metadata = @"res://*/AdventureWorksModel.csdl|
                            res://*/AdventureWorksModel.ssdl|
                            res://*/AdventureWorksModel.msl";
Console.WriteLine(entityBuilder.ToString());

using (EntityConnection conn =
    new EntityConnection(entityBuilder.ToString()))
{
    conn.Open();
    Console.WriteLine("Just testing the connection.");
    conn.Close();
}

' Specify the provider name, server and database.
Dim providerName As String = "System.Data.SqlClient"
Dim serverName As String = "."
Dim databaseName As String = "AdventureWorks"

' Initialize the connection string builder for the
' underlying provider.
Dim sqlBuilder As New SqlConnectionStringBuilder

' Set the properties for the data source.
sqlBuilder.DataSource = serverName
sqlBuilder.InitialCatalog = databaseName
sqlBuilder.IntegratedSecurity = True

' Build the SqlConnection connection string.
Dim providerString As String = sqlBuilder.ToString

' Initialize the EntityConnectionStringBuilder.
Dim entityBuilder As New EntityConnectionStringBuilder

'Set the provider name.
entityBuilder.Provider = providerName
' Set the provider-specific connection string.
entityBuilder.ProviderConnectionString = providerString
' Set the Metadata location to the current directory.
entityBuilder.Metadata = "res://*/AdventureWorksModel.csdl|" & _
                            "res://*/AdventureWorksModel.ssdl|" & _
                            "res://*/AdventureWorksModel.msl"

Console.WriteLine(entityBuilder.ToString)

Using conn As EntityConnection = New EntityConnection(entityBuilder.ToString)
    conn.Open()
    Console.WriteLine("Just testing the connection.")
    conn.Close()
End Using

Uwagi

Konstruktor parametry połączenia umożliwia deweloperom programowe tworzenie składniowo poprawnych parametrów połączenia oraz analizowanie i ponowne kompilowanie istniejących parametrów połączenia przy użyciu właściwości i metod klasy. Konstruktor parametry połączenia udostępnia silnie typizowane właściwości odpowiadające znanym parom słów kluczowych/wartości. Deweloperzy, którzy muszą tworzyć parametry połączenia w ramach aplikacji, mogą używać EntityConnectionStringBuilder klasy do kompilowania i modyfikowania parametrów połączenia.

Funkcja EntityConnectionStringBuilder wykonuje sprawdzanie prawidłowych par słów kluczowych/wartości, z których każda jest uwidoczniona jako EntityConnectionStringBuilder wartość właściwości.

Note

Właściwość parametry połączenia dla bazowego źródła danych jest dostarczana przez właściwość ProviderConnectionString. Podany dostawca parametry połączenia nie jest sprawdzany pod kątem prawidłowych par słów kluczowych/wartości.

Konstruktory

Nazwa	Opis
EntityConnectionStringBuilder()	Inicjuje nowe wystąpienie klasy EntityConnectionStringBuilder.
EntityConnectionStringBuilder(String)	Inicjuje nowe wystąpienie klasy EntityConnectionStringBuilder przy użyciu podanej parametry połączenia.

Właściwości

Nazwa	Opis
BrowsableConnectionString	Pobiera lub ustawia wartość wskazującą, czy właściwość ConnectionString jest widoczna w projektantach Visual Studio. (Odziedziczone po DbConnectionStringBuilder)
ConnectionString	Pobiera lub ustawia parametry połączenia skojarzone z DbConnectionStringBuilder. (Odziedziczone po DbConnectionStringBuilder)
Count	Pobiera bieżącą liczbę kluczy zawartych we ConnectionString właściwości . (Odziedziczone po DbConnectionStringBuilder)
IsFixedSize	Pobiera wartość wskazującą, czy EntityConnectionStringBuilder element ma stały rozmiar.
IsReadOnly	Pobiera wartość wskazującą, czy DbConnectionStringBuilder element jest tylko do odczytu. (Odziedziczone po DbConnectionStringBuilder)
Item[String]	Pobiera lub ustawia wartość skojarzona z określonym kluczem. W języku C#ta właściwość jest indeksatorem.
Keys	Pobiera element ICollection zawierający klucze w pliku EntityConnectionStringBuilder.
Metadata	Pobiera lub ustawia lokalizacje metadanych w parametry połączenia.
Name	Pobiera lub ustawia nazwę sekcji zgodnie z definicją w pliku konfiguracji.
Provider	Pobiera lub ustawia nazwę bazowego dostawcy danych platformy .NET Framework w parametry połączenia.
ProviderConnectionString	Pobiera lub ustawia wewnętrzny, specyficzny dla dostawcy parametry połączenia.
Values	Pobiera element ICollection zawierający wartości w obiekcie DbConnectionStringBuilder. (Odziedziczone po DbConnectionStringBuilder)

Metody

Nazwa	Opis
Add(String, Object)	Dodaje wpis z określonym kluczem i wartością do elementu DbConnectionStringBuilder. (Odziedziczone po DbConnectionStringBuilder)
Clear()	Czyści zawartość EntityConnectionStringBuilder wystąpienia.
ClearPropertyDescriptors()	Czyści kolekcję PropertyDescriptor obiektów na skojarzonym obiekcie DbConnectionStringBuilder. (Odziedziczone po DbConnectionStringBuilder)
ContainsKey(String)	Określa, czy EntityConnectionStringBuilder zawiera określony klucz.
Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
EquivalentTo(DbConnectionStringBuilder)	Porównuje informacje o połączeniu w tym DbConnectionStringBuilder obiekcie z informacjami o połączeniu w podanym obiekcie. (Odziedziczone po DbConnectionStringBuilder)
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetProperties(Hashtable)	Wypełnia element podany Hashtable przy użyciu informacji o wszystkich właściwościach tego obiektu DbConnectionStringBuilder. (Odziedziczone po DbConnectionStringBuilder)
GetType()	Pobiera Type bieżącego wystąpienia. (Odziedziczone po Object)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Object. (Odziedziczone po Object)
Remove(String)	Usuwa wpis z określonym kluczem z EntityConnectionStringBuilder wystąpienia.
ShouldSerialize(String)	Wskazuje, czy określony klucz istnieje w tym DbConnectionStringBuilder wystąpieniu. (Odziedziczone po DbConnectionStringBuilder)
ToString()	Zwraca parametry połączenia skojarzone z tym DbConnectionStringBuilder. (Odziedziczone po DbConnectionStringBuilder)
TryGetValue(String, Object)	Pobiera wartość odpowiadającą podanemu kluczowi z tego EntityConnectionStringBuilderelementu .

Jawne implementacje interfejsu

Nazwa	Opis
ICollection.CopyTo(Array, Int32)	Kopiuje elementy ICollection elementu do elementu Array, zaczynając od określonego Array indeksu. (Odziedziczone po DbConnectionStringBuilder)
ICollection.IsSynchronized	Pobiera wartość wskazującą, czy dostęp do ICollection jest synchronizowany (bezpieczny wątek). (Odziedziczone po DbConnectionStringBuilder)
ICollection.SyncRoot	Pobiera obiekt, który może służyć do synchronizowania dostępu do ICollection. (Odziedziczone po DbConnectionStringBuilder)
ICustomTypeDescriptor.GetAttributes()	Zwraca kolekcję atrybutów niestandardowych dla tego wystąpienia składnika. (Odziedziczone po DbConnectionStringBuilder)
ICustomTypeDescriptor.GetClassName()	Zwraca nazwę klasy tego wystąpienia składnika. (Odziedziczone po DbConnectionStringBuilder)
ICustomTypeDescriptor.GetComponentName()	Zwraca nazwę tego wystąpienia składnika. (Odziedziczone po DbConnectionStringBuilder)
ICustomTypeDescriptor.GetConverter()	Zwraca konwerter typów dla tego wystąpienia składnika. (Odziedziczone po DbConnectionStringBuilder)
ICustomTypeDescriptor.GetDefaultEvent()	Zwraca zdarzenie domyślne dla tego wystąpienia składnika. (Odziedziczone po DbConnectionStringBuilder)
ICustomTypeDescriptor.GetDefaultProperty()	Zwraca właściwość domyślną dla tego wystąpienia składnika. (Odziedziczone po DbConnectionStringBuilder)
ICustomTypeDescriptor.GetEditor(Type)	Zwraca edytor określonego typu dla tego wystąpienia składnika. (Odziedziczone po DbConnectionStringBuilder)
ICustomTypeDescriptor.GetEvents()	Zwraca zdarzenia dla tego wystąpienia składnika. (Odziedziczone po DbConnectionStringBuilder)
ICustomTypeDescriptor.GetEvents(Attribute[])	Zwraca zdarzenia dla tego wystąpienia składnika przy użyciu określonej tablicy atrybutów jako filtru. (Odziedziczone po DbConnectionStringBuilder)
ICustomTypeDescriptor.GetProperties()	Zwraca właściwości tego wystąpienia składnika. (Odziedziczone po DbConnectionStringBuilder)
ICustomTypeDescriptor.GetProperties(Attribute[])	Zwraca właściwości tego wystąpienia składnika przy użyciu tablicy atrybutów jako filtru. (Odziedziczone po DbConnectionStringBuilder)
ICustomTypeDescriptor.GetPropertyOwner(PropertyDescriptor)	Zwraca obiekt, który zawiera właściwość opisaną przez określony deskryptor właściwości. (Odziedziczone po DbConnectionStringBuilder)
IDictionary.Add(Object, Object)	Dodaje element z podanym kluczem i wartością IDictionary do obiektu. (Odziedziczone po DbConnectionStringBuilder)
IDictionary.Contains(Object)	Określa, IDictionary czy obiekt zawiera element z określonym kluczem. (Odziedziczone po DbConnectionStringBuilder)
IDictionary.GetEnumerator()	IDictionaryEnumerator Zwraca obiekt dla IDictionary obiektu. (Odziedziczone po DbConnectionStringBuilder)
IDictionary.Item[Object]	Pobiera lub ustawia element przy użyciu określonego klucza. (Odziedziczone po DbConnectionStringBuilder)
IDictionary.Remove(Object)	Usuwa element z określonym kluczem IDictionary z obiektu. (Odziedziczone po DbConnectionStringBuilder)
IEnumerable.GetEnumerator()	Zwraca moduł wyliczający, który iteruje za pośrednictwem kolekcji. (Odziedziczone po DbConnectionStringBuilder)

Metody rozszerzania

Nazwa	Opis
AsParallel(IEnumerable)	Umożliwia równoległość zapytania.
AsQueryable(IEnumerable)	Konwertuje IEnumerable na IQueryable.
Cast<TResult>(IEnumerable)	Rzutuje elementy IEnumerable do określonego typu.
OfType<TResult>(IEnumerable)	Filtruje elementy IEnumerable na podstawie określonego typu.

Dotyczy

Zobacz też

Opinia

Czy ta strona była pomocna?