EntityConnectionStringBuilder Klasa
Definicja
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.
Udostępnia 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
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 syntactycznie 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 zawiera 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 tworzenia i modyfikowania parametrów połączenia.
Wykonuje EntityConnectionStringBuilder sprawdzanie prawidłowych par słów kluczowych/wartości, z których każda jest uwidoczniona jako EntityConnectionStringBuilder wartość właściwości.
Uwaga
Parametry połączenia dla bazowego źródła danych jest dostarczana przez ProviderConnectionString właściwość . Podany dostawca parametry połączenia nie jest sprawdzany pod kątem prawidłowych par słowa kluczowego/wartości.
Konstruktory
EntityConnectionStringBuilder() |
Inicjuje nowe wystąpienie klasy EntityConnectionStringBuilder. |
EntityConnectionStringBuilder(String) |
Inicjuje EntityConnectionStringBuilder nowe wystąpienie klasy przy użyciu podanej parametry połączenia. |
Właściwości
BrowsableConnectionString |
Pobiera lub ustawia wartość wskazującą, czy ConnectionString właściwość jest widoczna dla projektantów programu Visual Studio. (Odziedziczone po DbConnectionStringBuilder) |
ConnectionString |
Pobiera lub ustawia parametry połączenia skojarzone z elementem 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 ma EntityConnectionStringBuilder stały rozmiar. |
IsReadOnly |
Pobiera wartość wskazującą, czy jest tylko DbConnectionStringBuilder 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 elemecie 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ę podstawowego dostawcy danych .NET Framework w parametry połączenia. |
ProviderConnectionString |
Pobiera lub ustawia wewnętrzny parametry połączenia specyficzny dla dostawcy. |
Values |
Pobiera element ICollection zawierający wartości w elemecie DbConnectionStringBuilder. (Odziedziczone po DbConnectionStringBuilder) |
Metody
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 element 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 dostarczone Hashtable informacje o wszystkich właściwościach tego DbConnectionStringBuilderobiektu . (Odziedziczone po DbConnectionStringBuilder) |
GetType() |
Type Pobiera bieżące wystąpienie. (Odziedziczone po Object) |
MemberwiseClone() |
Tworzy płytkią kopię bieżącego Objectelementu . (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 DbConnectionStringBuilderelementem . (Odziedziczone po DbConnectionStringBuilder) |
TryGetValue(String, Object) |
Pobiera wartość odpowiadającą podanemu kluczowi z tego EntityConnectionStringBuilderelementu . |
Jawne implementacje interfejsu
ICollection.CopyTo(Array, Int32) |
Kopiuje elementy ICollection elementu do obiektu Array, zaczynając od określonego Array indeksu. (Odziedziczone po DbConnectionStringBuilder) |
ICollection.IsSynchronized |
Pobiera wartość wskazującą, czy dostęp do elementu 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 obiektu 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 zawierający właściwość opisaną przez deskryptor określonej 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 po kolekcji. (Odziedziczone po DbConnectionStringBuilder) |
Metody rozszerzania
Cast<TResult>(IEnumerable) |
Rzutuje elementy elementu IEnumerable do określonego typu. |
OfType<TResult>(IEnumerable) |
Filtruje elementy elementu IEnumerable na podstawie określonego typu. |
AsParallel(IEnumerable) |
Umożliwia równoległość zapytania. |
AsQueryable(IEnumerable) |
Konwertuje element IEnumerable na .IQueryable |