EntityConnectionStringBuilder Classe
Definizione
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 modo semplice per creare e gestire il contenuto delle stringhe di connessione usate 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à
Esempio
Nell'esempio seguente viene illustrato come usare insieme EntityConnectionStringBuilder 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 stringhe di connessione sintatticamente corrette e analizzare e ricompilare le stringhe di connessione esistenti usando proprietà e metodi della classe . Il generatore di stringhe di connessione fornisce proprietà fortemente tipizzate corrispondenti alle coppie di parole chiave/valore note. Gli sviluppatori che devono creare stringhe di connessione come parte delle applicazioni possono usare la EntityConnectionStringBuilder classe per compilare e modificare le stringhe di connessione.
EntityConnectionStringBuilder esegue controlli per le coppie di parole chiave/valore valide, ognuna delle quali viene esposta come valore della EntityConnectionStringBuilder proprietà.
Annotazioni
La stringa di connessione per l'origine dati sottostante viene fornita dalla ProviderConnectionString proprietà . La stringa di connessione del provider specificata non è selezionata per le coppie di parole chiave/valore valide.
Costruttori
| Nome | Descrizione |
|---|---|
| EntityConnectionStringBuilder() |
Inizializza una nuova istanza della classe EntityConnectionStringBuilder. |
| EntityConnectionStringBuilder(String) |
Inizializza una nuova istanza della EntityConnectionStringBuilder classe utilizzando la stringa di connessione fornita. |
Proprietà
| Nome | Descrizione |
|---|---|
| BrowsableConnectionString |
Ottiene o imposta un valore che indica se la ConnectionString proprietà è 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 ConnectionString proprietà . (Ereditato da DbConnectionStringBuilder) |
| IsFixedSize |
Ottiene un valore che indica se ha EntityConnectionStringBuilder una dimensione fissa. |
| IsReadOnly |
Ottiene un valore che indica se l'oggetto 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 contenente le chiavi nell'oggetto 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 nella stringa di connessione. |
| ProviderConnectionString |
Ottiene o imposta la stringa di connessione interna specifica del provider. |
| Values |
Ottiene un oggetto ICollection che contiene i valori nell'oggetto DbConnectionStringBuilder. (Ereditato da DbConnectionStringBuilder) |
Metodi
| Nome | Descrizione |
|---|---|
| Add(String, Object) |
Aggiunge una voce con la chiave e il valore specificati in DbConnectionStringBuilder. (Ereditato da DbConnectionStringBuilder) |
| Clear() |
Cancella il contenuto dell'istanza EntityConnectionStringBuilder . |
| ClearPropertyDescriptors() |
Cancella la raccolta di PropertyDescriptor oggetti nell'oggetto associato DbConnectionStringBuilder. (Ereditato da DbConnectionStringBuilder) |
| ContainsKey(String) |
Determina se contiene EntityConnectionStringBuilder una chiave specifica. |
| Equals(Object) |
Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object) |
| EquivalentTo(DbConnectionStringBuilder) |
Confronta le informazioni di connessione in questo DbConnectionStringBuilder oggetto con le informazioni di connessione nell'oggetto fornito. (Ereditato da DbConnectionStringBuilder) |
| GetHashCode() |
Funge da funzione hash predefinita. (Ereditato da Object) |
| GetProperties(Hashtable) |
Riempie un oggetto fornito Hashtable con informazioni su tutte le proprietà di questo DbConnectionStringBuilderoggetto . (Ereditato da DbConnectionStringBuilder) |
| GetType() |
Ottiene il Type dell'istanza corrente. (Ereditato da Object) |
| MemberwiseClone() |
Crea una copia superficiale del Objectcorrente. (Ereditato da Object) |
| Remove(String) |
Rimuove la voce con la chiave specificata dall'istanza EntityConnectionStringBuilder di . |
| ShouldSerialize(String) |
Indica se la chiave specificata esiste in questa DbConnectionStringBuilder istanza. (Ereditato da DbConnectionStringBuilder) |
| ToString() |
Restituisce la stringa di connessione associata all'oggetto DbConnectionStringBuilder. (Ereditato da DbConnectionStringBuilder) |
| TryGetValue(String, Object) |
Recupera un valore corrispondente alla chiave fornita da questo EntityConnectionStringBuilderoggetto . |
Implementazioni dell'interfaccia esplicita
| Nome | Descrizione |
|---|---|
| ICollection.CopyTo(Array, Int32) |
Copia gli elementi di in ICollection un Arrayoggetto , a partire da un indice specifico Array . (Ereditato da DbConnectionStringBuilder) |
| ICollection.IsSynchronized |
Ottiene un valore che indica se l'accesso ICollection a è sincronizzato (thread-safe). (Ereditato da DbConnectionStringBuilder) |
| ICollection.SyncRoot |
Ottiene un oggetto che può essere utilizzato per sincronizzare l'accesso all'oggetto 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 utilizzando la matrice di attributi specificata come filtro. (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 utilizzando la matrice di attributi come filtro. (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 specificati 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 IDictionaryEnumerator oggetto 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 l'elemento con la chiave specificata dall'oggetto IDictionary . (Ereditato da DbConnectionStringBuilder) |
| IEnumerable.GetEnumerator() |
Restituisce un enumeratore che scorre un insieme. (Ereditato da DbConnectionStringBuilder) |
Metodi di estensione
| Nome | Descrizione |
|---|---|
| AsParallel(IEnumerable) |
Abilita la parallelizzazione di una query. |
| AsQueryable(IEnumerable) |
Converte un IEnumerable in un IQueryable. |
| Cast<TResult>(IEnumerable) |
Esegue il cast degli elementi di un IEnumerable al tipo specificato. |
| OfType<TResult>(IEnumerable) |
Filtra gli elementi di un IEnumerable in base a un tipo specificato. |