EntityConnectionStringBuilder Classe

Définition

Espace de noms:

System.Data.EntityClient

Assembly:

System.Data.Entity.dll

Fournit un moyen simple de créer et de gérer le contenu de chaînes de connexion utilisées par 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

Héritage

Object

DbConnectionStringBuilder

EntityConnectionStringBuilder

Exemples

L'exemple ci-dessous montre comment utiliser l'objet EntityConnectionStringBuilder avec un objet 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

Remarques

Le générateur de chaînes de connexion permet aux développeurs de créer par programme des chaînes de connexion correctes du point de vue de la syntaxe, et d'analyser et régénérer des chaînes de connexion existantes, à l'aide de propriétés et de méthodes de la classe. Le générateur de chaînes de connexion fournit des propriétés fortement typées correspondant aux paires mot clé/valeur connues. Les développeurs qui doivent créer des chaînes de connexion dans le cadre d'applications peuvent utiliser la classe EntityConnectionStringBuilder pour générer et modifier des chaînes de connexion.

EntityConnectionStringBuilder vérifie la validité des paires mot clé/valeur, chacune d'elles étant exposée sous la forme d'une valeur de propriété EntityConnectionStringBuilder.

Notes

La chaîne de connexion de la source de données sous-jacente est fournie par la propriété ProviderConnectionString. La validité des paires mot clé/valeur de la chaîne de connexion de fournisseur spécifiée n'est pas vérifiée.

Constructeurs

EntityConnectionStringBuilder()	Initialise une nouvelle instance de la classe EntityConnectionStringBuilder.
EntityConnectionStringBuilder(String)	Initialise une nouvelle instance de la classe EntityConnectionStringBuilder à l'aide de la chaîne de connexion spécifiée.

Propriétés

BrowsableConnectionString	Obtient ou définit une valeur qui indique si la propriété ConnectionString est visible dans les concepteurs Visual Studio. (Hérité de DbConnectionStringBuilder)
ConnectionString	Obtient ou définit la chaîne de connexion associée au DbConnectionStringBuilder. (Hérité de DbConnectionStringBuilder)
Count	Obtient le nombre actuel de clés contenues dans la propriété ConnectionString. (Hérité de DbConnectionStringBuilder)
IsFixedSize	Obtient une valeur qui indique si EntityConnectionStringBuilder est de taille fixe.
IsReadOnly	Obtient une valeur qui indique si l’objet DbConnectionStringBuilder est en lecture seule. (Hérité de DbConnectionStringBuilder)
Item[String]	Obtient ou définit la valeur associée à la clé spécifiée. En C#, cette propriété est l'indexeur.
Keys	Obtient un ICollection qui contient les clés de EntityConnectionStringBuilder.
Metadata	Obtient ou définit l'emplacement des métadonnées dans la chaîne de connexion.
Name	Obtient ou définit le nom d'une section tel que défini dans un fichier de configuration.
Provider	Obtient ou définit le nom du fournisseur de données .NET Framework sous-jacent dans le chaîne de connexion.
ProviderConnectionString	Obtient ou définit la chaîne de connexion interne, spécifique au fournisseur.
Values	Obtient un objet ICollection qui contient les valeurs de l'objet DbConnectionStringBuilder. (Hérité de DbConnectionStringBuilder)

Méthodes

Add(String, Object)	Ajoute une entrée avec la clé et la valeur spécifiées dans DbConnectionStringBuilder. (Hérité de DbConnectionStringBuilder)
Clear()	Efface le contenu de l'instance EntityConnectionStringBuilder.
ClearPropertyDescriptors()	Efface la collection d’objets PropertyDescriptor du DbConnectionStringBuilder associé. (Hérité de DbConnectionStringBuilder)
ContainsKey(String)	Détermine si EntityConnectionStringBuilder contient une clé spécifique.
Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
EquivalentTo(DbConnectionStringBuilder)	Compare les informations de connexion de cet objet DbConnectionStringBuilder avec les informations de connexion de l’objet fourni. (Hérité de DbConnectionStringBuilder)
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetProperties(Hashtable)	Remplit un Hashtable fourni avec des informations sur toutes les propriétés de ce DbConnectionStringBuilder. (Hérité de DbConnectionStringBuilder)
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
Remove(String)	Supprime l'entrée contenant la clé spécifiée dans l'instance de EntityConnectionStringBuilder.
ShouldSerialize(String)	Indique si la clé spécifiée existe dans cette instance de DbConnectionStringBuilder. (Hérité de DbConnectionStringBuilder)
ToString()	Retourne la chaîne de connexion associée à ce DbConnectionStringBuilder. (Hérité de DbConnectionStringBuilder)
TryGetValue(String, Object)	Récupère une valeur correspondant à la clé fournie à partir de cet objet EntityConnectionStringBuilder.

Implémentations d’interfaces explicites

ICollection.CopyTo(Array, Int32)	Copie les éléments de ICollection dans Array, à partir d'un index particulier de Array. (Hérité de DbConnectionStringBuilder)
ICollection.IsSynchronized	Obtient une valeur indiquant si l’accès à ICollection est synchronisé (thread-safe). (Hérité de DbConnectionStringBuilder)
ICollection.SyncRoot	Obtient un objet qui peut être utilisé pour synchroniser l’accès à ICollection. (Hérité de DbConnectionStringBuilder)
ICustomTypeDescriptor.GetAttributes()	Retourne une collection d’attributs personnalisés pour cette instance d’un composant. (Hérité de DbConnectionStringBuilder)
ICustomTypeDescriptor.GetClassName()	Retourne le nom de classe de cette instance d’un composant. (Hérité de DbConnectionStringBuilder)
ICustomTypeDescriptor.GetComponentName()	Retourne le nom de cette instance d’un composant. (Hérité de DbConnectionStringBuilder)
ICustomTypeDescriptor.GetConverter()	Retourne un convertisseur de type pour cette instance d’un composant. (Hérité de DbConnectionStringBuilder)
ICustomTypeDescriptor.GetDefaultEvent()	Retourne l’événement par défaut pour cette instance d’un composant. (Hérité de DbConnectionStringBuilder)
ICustomTypeDescriptor.GetDefaultProperty()	Retourne la propriété par défaut pour cette instance d’un composant. (Hérité de DbConnectionStringBuilder)
ICustomTypeDescriptor.GetEditor(Type)	Retourne un éditeur du type spécifié pour cette instance d’un composant. (Hérité de DbConnectionStringBuilder)
ICustomTypeDescriptor.GetEvents()	Retourne les événements pour cette instance d’un composant. (Hérité de DbConnectionStringBuilder)
ICustomTypeDescriptor.GetEvents(Attribute[])	Retourne les événements pour cette instance d’un composant à l’aide du tableau d’attributs spécifié comme filtre. (Hérité de DbConnectionStringBuilder)
ICustomTypeDescriptor.GetProperties()	Retourne les propriétés pour cette instance d’un composant. (Hérité de DbConnectionStringBuilder)
ICustomTypeDescriptor.GetProperties(Attribute[])	Retourne les propriétés de cette instance d’un composant à l’aide du tableau d’attributs comme filtre. (Hérité de DbConnectionStringBuilder)
ICustomTypeDescriptor.GetPropertyOwner(PropertyDescriptor)	Retourne un objet qui contient la propriété décrite par le descripteur de propriété spécifié. (Hérité de DbConnectionStringBuilder)
IDictionary.Add(Object, Object)	Ajoute un élément avec la clé et la valeur fournies à l'objet IDictionary. (Hérité de DbConnectionStringBuilder)
IDictionary.Contains(Object)	Détermine si l'objet IDictionary contient un élément avec la clé spécifiée. (Hérité de DbConnectionStringBuilder)
IDictionary.GetEnumerator()	Retourne un objet IDictionaryEnumerator pour l’objet IDictionary. (Hérité de DbConnectionStringBuilder)
IDictionary.Item[Object]	Obtient ou définit l'élément à l'aide de la clé spécifiée. (Hérité de DbConnectionStringBuilder)
IDictionary.Remove(Object)	Supprime de l’objet IDictionary l’élément ayant la clé spécifiée. (Hérité de DbConnectionStringBuilder)
IEnumerable.GetEnumerator()	Retourne un énumérateur qui itère au sein d’une collection. (Hérité de DbConnectionStringBuilder)

Méthodes d’extension

Cast<TResult>(IEnumerable)	Effectue un cast des éléments d'un IEnumerable vers le type spécifié.
OfType<TResult>(IEnumerable)	Filtre les éléments d'un IEnumerable en fonction du type spécifié.
AsParallel(IEnumerable)	Active la parallélisation d'une requête.
AsQueryable(IEnumerable)	Convertit un IEnumerable en IQueryable.

Voir aussi

• EntityConnection
• Chaînes de connexion
• Utilisation d'EntityClient