EntityConnectionStringBuilder Classe

Riferimento

Definizione

Spazio dei nomi:: System.Data.EntityClient

Assembly:: System.Data.Entity.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Fornisce un metodo per creare e gestire facilmente il contenuto delle stringhe di connessione utilizzate da EntityClient.

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

Ereditarietà: Object

DbConnectionStringBuilder
EntityConnectionStringBuilder

Esempio

Nell'esempio seguente viene illustrato come utilizzare EntityConnectionStringBuilder insieme a un oggetto 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

Commenti

Il generatore di stringhe di connessione consente agli sviluppatori di creare a livello di codice stringhe di connessione sintatticamente corrette, nonché di analizzare e ricompilare le stringhe di connessione esistenti, utilizzando le proprietà e i metodi della classe. Il generatore di stringhe di connessione fornisce proprietà fortemente tipizzate corrispondenti alle coppie parola chiave/valore note. Gli sviluppatori che devono creare stringhe di connessione come parte delle applicazioni, possono utilizzare la classe EntityConnectionStringBuilder per compilare e modificare tali stringhe.

EntityConnectionStringBuilder esegue i controlli di validità delle coppie parola chiave/valore, ognuna delle quali è esposta come valore della proprietà EntityConnectionStringBuilder.

Nota

La stringa di connessione per l'origine dati sottostante è fornita dalla proprietà ProviderConnectionString. Per la stringa di connessione del provider fornita non viene verificata la validità delle coppie parola chiave/valore.

Costruttori

EntityConnectionStringBuilder()	Inizializza una nuova istanza della classe EntityConnectionStringBuilder.
EntityConnectionStringBuilder(String)	Inizializza una nuova istanza della classe EntityConnectionStringBuilder utilizzando la stringa di connessione fornita.

Proprietà

BrowsableConnectionString	Ottiene o imposta un valore che indica se la proprietà ConnectionString è visibile nelle finestre di progettazione di Visual Studio. (Ereditato da DbConnectionStringBuilder)
ConnectionString	Ottiene o imposta la stringa di connessione associata all'oggetto DbConnectionStringBuilder. (Ereditato da DbConnectionStringBuilder)
Count	Ottiene il numero corrente di chiavi contenute all'interno della proprietà ConnectionString. (Ereditato da DbConnectionStringBuilder)
IsFixedSize	Ottiene un valore che indica se le dimensioni dell'oggetto EntityConnectionStringBuilder sono fisse.
IsReadOnly	Ottiene un valore che indica se DbConnectionStringBuilder è di sola lettura. (Ereditato da DbConnectionStringBuilder)
Item[String]	Ottiene o imposta il valore associato alla chiave specificata. In C# questa proprietà è l'indicizzatore.
Keys	Ottiene un oggetto ICollection che contiene le chiavi presenti in EntityConnectionStringBuilder.
Metadata	Ottiene o imposta i percorsi dei metadati nella stringa di connessione.
Name	Ottiene o imposta il nome di una sezione come definito in un file di configurazione.
Provider	Ottiene o imposta il nome del provider di dati .NET Framework sottostante nel stringa di connessione.
ProviderConnectionString	Ottiene o imposta la stringa di connessione interna specifica del provider.
Values	Ottiene un oggetto ICollection contenente i valori di DbConnectionStringBuilder. (Ereditato da DbConnectionStringBuilder)

Metodi

Add(String, Object)	Aggiunge una voce con la chiave e il valore specificati nell'oggetto DbConnectionStringBuilder. (Ereditato da DbConnectionStringBuilder)
Clear()	Cancella il contenuto dell'istanza di EntityConnectionStringBuilder.
ClearPropertyDescriptors()	Cancella la raccolta di oggetti PropertyDescriptor per l'oggetto DbConnectionStringBuilder associato. (Ereditato da DbConnectionStringBuilder)
ContainsKey(String)	Determina se l'oggetto EntityConnectionStringBuilder contiene una chiave specifica.
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
EquivalentTo(DbConnectionStringBuilder)	Confronta le informazioni sulla connessione in questo oggetto DbConnectionStringBuilder con le informazioni sulla connessione nell'oggetto fornito. (Ereditato da DbConnectionStringBuilder)
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetProperties(Hashtable)	Compila un oggetto Hashtable fornito con informazioni su tutte le proprietà di DbConnectionStringBuilder. (Ereditato da DbConnectionStringBuilder)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
Remove(String)	Rimuove la voce con la chiave specificata dall'istanza di EntityConnectionStringBuilder.
ShouldSerialize(String)	Indica se la chiave specificata esiste in questa istanza DbConnectionStringBuilder. (Ereditato da DbConnectionStringBuilder)
ToString()	Restituisce la stringa di connessione associata a questo oggetto DbConnectionStringBuilder. (Ereditato da DbConnectionStringBuilder)
TryGetValue(String, Object)	Recupera un valore che corrisponde alla chiave fornita da questo oggetto EntityConnectionStringBuilder.

Implementazioni dell'interfaccia esplicita

ICollection.CopyTo(Array, Int32)	Copia gli elementi di ICollection in Array a partire da un particolare indice Array. (Ereditato da DbConnectionStringBuilder)
ICollection.IsSynchronized	Ottiene un valore che indica se l'accesso a ICollection è sincronizzato (thread-safe). (Ereditato da DbConnectionStringBuilder)
ICollection.SyncRoot	Ottiene un oggetto che può essere usato per sincronizzare l'accesso a ICollection. (Ereditato da DbConnectionStringBuilder)
ICustomTypeDescriptor.GetAttributes()	Restituisce una raccolta di attributi personalizzati per questa istanza di un componente. (Ereditato da DbConnectionStringBuilder)
ICustomTypeDescriptor.GetClassName()	Restituisce il nome della classe di questa istanza di un componente. (Ereditato da DbConnectionStringBuilder)
ICustomTypeDescriptor.GetComponentName()	Restituisce il nome di questa istanza di un componente. (Ereditato da DbConnectionStringBuilder)
ICustomTypeDescriptor.GetConverter()	Restituisce un convertitore di tipi per questa istanza di un componente. (Ereditato da DbConnectionStringBuilder)
ICustomTypeDescriptor.GetDefaultEvent()	Restituisce l'evento predefinito per questa istanza di un componente. (Ereditato da DbConnectionStringBuilder)
ICustomTypeDescriptor.GetDefaultProperty()	Restituisce la proprietà predefinita per questa istanza di un componente. (Ereditato da DbConnectionStringBuilder)
ICustomTypeDescriptor.GetEditor(Type)	Restituisce un editor del tipo specificato per questa istanza di un componente. (Ereditato da DbConnectionStringBuilder)
ICustomTypeDescriptor.GetEvents()	Restituisce gli eventi per questa istanza di un componente. (Ereditato da DbConnectionStringBuilder)
ICustomTypeDescriptor.GetEvents(Attribute[])	Restituisce gli eventi per questa istanza di un componente usando come filtro la matrice di attributi specificata. (Ereditato da DbConnectionStringBuilder)
ICustomTypeDescriptor.GetProperties()	Restituisce le proprietà per questa istanza di un componente. (Ereditato da DbConnectionStringBuilder)
ICustomTypeDescriptor.GetProperties(Attribute[])	Restituisce le proprietà per questa istanza di un componente usando come filtro la matrice di attributi. (Ereditato da DbConnectionStringBuilder)
ICustomTypeDescriptor.GetPropertyOwner(PropertyDescriptor)	Restituisce un oggetto che contiene la proprietà descritta dal descrittore di proprietà specificato. (Ereditato da DbConnectionStringBuilder)
IDictionary.Add(Object, Object)	Aggiunge un elemento con la chiave e il valore forniti all'oggetto IDictionary. (Ereditato da DbConnectionStringBuilder)
IDictionary.Contains(Object)	Determina se l'oggetto IDictionary contiene un elemento con la chiave specificata. (Ereditato da DbConnectionStringBuilder)
IDictionary.GetEnumerator()	Restituisce un oggetto IDictionaryEnumerator per l'oggetto IDictionary. (Ereditato da DbConnectionStringBuilder)
IDictionary.Item[Object]	Ottiene o imposta l'elemento con la chiave specificata. (Ereditato da DbConnectionStringBuilder)
IDictionary.Remove(Object)	Rimuove dall'oggetto IDictionary l'elemento con la chiave specificata. (Ereditato da DbConnectionStringBuilder)
IEnumerable.GetEnumerator()	Restituisce un enumeratore che consente di eseguire l'iterazione di una raccolta. (Ereditato da DbConnectionStringBuilder)

Metodi di estensione

Cast<TResult>(IEnumerable)	Esegue il cast degli elementi di un oggetto IEnumerable nel tipo specificato.
OfType<TResult>(IEnumerable)	Filtra gli elementi di un oggetto IEnumerable in base a un tipo specificato.
AsParallel(IEnumerable)	Consente la parallelizzazione di una query.
AsQueryable(IEnumerable)	Converte un oggetto IEnumerable in un oggetto IQueryable.

Si applica a