Condividi tramite


EntityConnectionStringBuilder Classe

Definizione

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à
EntityConnectionStringBuilder

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.

Si applica a

Vedi anche