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 des 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 suivant montre comment utiliser la EntityConnectionStringBuilder combinaison avec un 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 programmation des chaînes de connexion correctes par programmation, d’analyser et de reconstruire 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 EntityConnectionStringBuilder classe pour générer et modifier des chaînes de connexion.

L’opération EntityConnectionStringBuilder vérifie les paires mot clé/valeur valides, chacune d’elles étant exposée sous forme EntityConnectionStringBuilder de valeur de propriété.

Note

La chaîne de connexion de la source de données sous-jacente est fournie par la ProviderConnectionString propriété. La chaîne de connexion du fournisseur fournie n’est pas vérifiée pour les paires mot clé/valeur valides.

Constructeurs

Nom	Description
EntityConnectionStringBuilder()	Initialise une nouvelle instance de la classe EntityConnectionStringBuilder.
EntityConnectionStringBuilder(String)	Initialise une nouvelle instance de la EntityConnectionStringBuilder classe à l’aide de la chaîne de connexion fournie.

Propriétés

Nom	Description
BrowsableConnectionString	Obtient ou définit une valeur qui indique si la ConnectionString propriété 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 ConnectionString propriété. (Hérité de DbConnectionStringBuilder)
IsFixedSize	Obtient une valeur qui indique si la EntityConnectionStringBuilder taille fixe est définie.
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 dans le EntityConnectionStringBuilder.
Metadata	Obtient ou définit les emplacements de métadonnées dans la chaîne de connexion.
Name	Obtient ou définit le nom d’une section telle que définie dans un fichier de configuration.
Provider	Obtient ou définit le nom du fournisseur de données .NET Framework sous-jacent dans la chaîne de connexion.
ProviderConnectionString	Obtient ou définit la chaîne de connexion interne spécifique au fournisseur.
Values	Obtient un ICollection qui contient les valeurs dans le DbConnectionStringBuilder. (Hérité de DbConnectionStringBuilder)

Méthodes

Nom	Description
Add(String, Object)	Ajoute une entrée avec la clé et la valeur spécifiées dans le DbConnectionStringBuilder. (Hérité de DbConnectionStringBuilder)
Clear()	Efface le contenu de l’instance EntityConnectionStringBuilder .
ClearPropertyDescriptors()	Efface la collection d’objets PropertyDescriptor sur l’objet associé DbConnectionStringBuilder. (Hérité de DbConnectionStringBuilder)
ContainsKey(String)	Détermine si le EntityConnectionStringBuilder conteneur 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 dans cet DbConnectionStringBuilder objet avec les informations de connexion de l’objet fourni. (Hérité de DbConnectionStringBuilder)
GetHashCode()	Sert de fonction de hachage par défaut. (Hérité de Object)
GetProperties(Hashtable)	Remplit un fourni Hashtable avec des informations sur toutes les propriétés de ce DbConnectionStringBuilder. (Hérité de DbConnectionStringBuilder)
GetType()	Obtient la Type de l’instance actuelle. (Hérité de Object)
MemberwiseClone()	Crée une copie superficielle du Objectactuel. (Hérité de Object)
Remove(String)	Supprime l’entrée avec la clé spécifiée de l’instance EntityConnectionStringBuilder .
ShouldSerialize(String)	Indique si la clé spécifiée existe dans cette DbConnectionStringBuilder instance. (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 ce EntityConnectionStringBuilder.

Implémentations d’interfaces explicites

Nom	Description
ICollection.CopyTo(Array, Int32)	Copie les éléments d’un ICollection index particulier à partir Arrayd’un index particulier Array . (Hérité de DbConnectionStringBuilder)
ICollection.IsSynchronized	Obtient une valeur indiquant si l’accès à l’objet ICollection est synchronisé (thread safe). (Hérité de DbConnectionStringBuilder)
ICollection.SyncRoot	Obtient un objet qui peut être utilisé pour synchroniser l’accès ICollectionau . (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 de cette instance d’un composant. (Hérité de DbConnectionStringBuilder)
ICustomTypeDescriptor.GetEvents(Attribute[])	Retourne les événements de cette instance d’un composant à l’aide du tableau d’attributs spécifié en tant que filtre. (Hérité de DbConnectionStringBuilder)
ICustomTypeDescriptor.GetProperties()	Retourne les propriétés de 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 en tant que 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 IDictionaryEnumerator objet pour l’objet IDictionary . (Hérité de DbConnectionStringBuilder)
IDictionary.Item[Object]	Obtient ou définit l’élément avec la clé spécifiée. (Hérité de DbConnectionStringBuilder)
IDictionary.Remove(Object)	Supprime l’élément avec la clé spécifiée de l’objet IDictionary . (Hérité de DbConnectionStringBuilder)
IEnumerable.GetEnumerator()	Retourne un énumérateur qui itère dans une collection. (Hérité de DbConnectionStringBuilder)

Méthodes d’extension

Nom	Description
AsParallel(IEnumerable)	Active la parallélisation d’une requête.
AsQueryable(IEnumerable)	Convertit un IEnumerable en IQueryable.
Cast<TResult>(IEnumerable)	Convertit les éléments d’un IEnumerable en type spécifié.
OfType<TResult>(IEnumerable)	Filtre les éléments d’une IEnumerable en fonction d’un type spécifié.

Voir aussi

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