Exporter (0) Imprimer
Développer tout
Cet article a fait l'objet d'une traduction automatique. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte. Informations supplémentaires.
Traduction
Source

EntityConnectionStringBuilder, classe

Fournit un moyen simple de créer et de gérer le contenu de chaînes de connexion utilisées par EntityClient.

System.Object
  System.Data.Common.DbConnectionStringBuilder
    System.Data.EntityClient.EntityConnectionStringBuilder

Espace de noms :  System.Data.EntityClient
Assembly :  System.Data.Entity (dans System.Data.Entity.dll)

public sealed class EntityConnectionStringBuilder : DbConnectionStringBuilder

Le type EntityConnectionStringBuilder expose les membres suivants.

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

  NomDescription
Propriété publiqueBrowsableConnectionStringObtient ou définit une valeur qui indique si la propriété ConnectionString est visible dans les Concepteurs Visual Studio. (Hérité de DbConnectionStringBuilder.)
Propriété publiqueConnectionStringObtient ou définit la chaîne de connexion associée à DbConnectionStringBuilder. (Hérité de DbConnectionStringBuilder.)
Propriété publiqueCountObtient le nombre actuel des clés contenues dans la propriété ConnectionString. (Hérité de DbConnectionStringBuilder.)
Propriété publiqueIsFixedSizeObtient une valeur qui indique si EntityConnectionStringBuilder est de taille fixe. (Substitue DbConnectionStringBuilder.IsFixedSize.)
Propriété publiqueIsReadOnlyObtient une valeur qui indique si DbConnectionStringBuilder est en lecture seule. (Hérité de DbConnectionStringBuilder.)
Propriété publiqueItemObtient ou définit la valeur associée à la clé spécifiée. En C#, cette propriété est l'indexeur. (Substitue DbConnectionStringBuilder.Item.)
Propriété publiqueKeysObtient un ICollection qui contient les clés de EntityConnectionStringBuilder. (Substitue DbConnectionStringBuilder.Keys.)
Propriété publiqueMetadataObtient ou définit les emplacements des métadonnées dans la chaîne de connexion.
Propriété publiqueNameObtient ou définit le nom d'une section tel que défini dans un fichier de configuration.
Propriété publiqueProviderObtient ou définit le nom du fournisseur de données .NET Framework sous-jacent dans la chaîne de connexion.
Propriété publiqueProviderConnectionStringObtient ou définit la chaîne de connexion interne, spécifique au fournisseur.
Propriété publiqueValuesObtient un ICollection qui contient les valeurs de DbConnectionStringBuilder. (Hérité de DbConnectionStringBuilder.)
Début

  NomDescription
Méthode publiqueAddAjoute une entrée avec la clé et la valeur spécifiées dans DbConnectionStringBuilder. (Hérité de DbConnectionStringBuilder.)
Méthode publiqueClearEfface le contenu de l'instance de EntityConnectionStringBuilder. (Substitue DbConnectionStringBuilder.Clear().)
Méthode protégéeClearPropertyDescriptorsEfface la collection d'objets PropertyDescriptor sur le DbConnectionStringBuilder associé. (Hérité de DbConnectionStringBuilder.)
Méthode publiqueContainsKeyDétermine si EntityConnectionStringBuilder contient une clé spécifique. (Substitue DbConnectionStringBuilder.ContainsKey(String).)
Méthode publiqueEquals(Object)Détermine si l'objet spécifié est identique à l'objet actuel. (Hérité de Object.)
Méthode publiqueEquivalentToCompare les informations de connexion dans cet objet DbConnectionStringBuilder avec les informations de connexion dans l'objet fourni. (Hérité de DbConnectionStringBuilder.)
Méthode publiqueGetHashCodeSert de fonction de hachage par défaut. (Hérité de Object.)
Méthode publiqueGetTypeObtient le Type de l'instance actuelle. (Hérité de Object.)
Méthode publiqueRemoveSupprime l'entrée contenant la clé spécifiée provenant de l'instance de EntityConnectionStringBuilder. (Substitue DbConnectionStringBuilder.Remove(String).)
Méthode publiqueShouldSerializeIndique si la clé spécifiée existe dans cette instance de DbConnectionStringBuilder. (Hérité de DbConnectionStringBuilder.)
Méthode publiqueToStringRetourne la chaîne de connexion associée à ce DbConnectionStringBuilder. (Hérité de DbConnectionStringBuilder.)
Méthode publiqueTryGetValueRécupère une valeur qui correspond à la clé fournie de ce EntityConnectionStringBuilder. (Substitue DbConnectionStringBuilder.TryGetValue(String, Object).)
Début

  NomDescription
Implémentation d'interface expliciteMéthode privéeICollection.CopyToCopie les éléments de ICollection dans Array, en commençant à un index particulier de Array. (Hérité de DbConnectionStringBuilder.)
Implémentation d'interface explicitePropriété privéeICollection.IsSynchronizedObtient une valeur indiquant si l'accès à ICollection est synchronisé (thread-safe). (Hérité de DbConnectionStringBuilder.)
Implémentation d'interface explicitePropriété privéeICollection.SyncRootObtient un objet qui peut être utilisé pour synchroniser l'accès à ICollection. (Hérité de DbConnectionStringBuilder.)
Implémentation d'interface expliciteMéthode privéeICustomTypeDescriptor.GetAttributesRetourne une collection d'attributs personnalisés pour cette instance d'un composant. (Hérité de DbConnectionStringBuilder.)
Implémentation d'interface expliciteMéthode privéeICustomTypeDescriptor.GetClassNameRetourne le nom de la classe de cette instance d'un composant. (Hérité de DbConnectionStringBuilder.)
Implémentation d'interface expliciteMéthode privéeICustomTypeDescriptor.GetComponentNameRetourne le nom de cette instance d'un composant. (Hérité de DbConnectionStringBuilder.)
Implémentation d'interface expliciteMéthode privéeICustomTypeDescriptor.GetConverterRetourne un convertisseur de type de cette instance d'un composant. (Hérité de DbConnectionStringBuilder.)
Implémentation d'interface expliciteMéthode privéeICustomTypeDescriptor.GetDefaultEventRetourne les événements par défaut pour cette instance d'un composant. (Hérité de DbConnectionStringBuilder.)
Implémentation d'interface expliciteMéthode privéeICustomTypeDescriptor.GetDefaultPropertyRetourne la propriété par défaut pour cette instance d'un composant. (Hérité de DbConnectionStringBuilder.)
Implémentation d'interface expliciteMéthode privéeICustomTypeDescriptor.GetEditorRetourne un éditeur du type spécifié pour cette instance d'un composant. (Hérité de DbConnectionStringBuilder.)
Implémentation d'interface expliciteMéthode privéeICustomTypeDescriptor.GetEvents()Retourne les événements correspondant à cette instance d'un composant. (Hérité de DbConnectionStringBuilder.)
Implémentation d'interface expliciteMéthode privéeICustomTypeDescriptor.GetEvents(Attribute[])Retourne les événements pour cette instance d'un composant à l'aide du tableau d'attributs spécifié en tant que filtre. (Hérité de DbConnectionStringBuilder.)
Implémentation d'interface expliciteMéthode privéeICustomTypeDescriptor.GetProperties()Retourne les propriétés de cette instance d'un composant. (Hérité de DbConnectionStringBuilder.)
Implémentation d'interface expliciteMéthode privéeICustomTypeDescriptor.GetProperties(Attribute[])Retourne les propriétés pour cette instance d'un composant en utilisant le tableau d'attributs comme filtre. (Hérité de DbConnectionStringBuilder.)
Implémentation d'interface expliciteMéthode privéeICustomTypeDescriptor.GetPropertyOwnerRetourne un objet qui contient la propriété décrite par le descripteur de propriété spécifié. (Hérité de DbConnectionStringBuilder.)
Implémentation d'interface expliciteMéthode privéeIDictionary.AddAjoute un élément avec la clé et la valeur fournies à l'objet IDictionary. (Hérité de DbConnectionStringBuilder.)
Implémentation d'interface expliciteMéthode privéeIDictionary.ContainsDétermine si l'objet IDictionary contient un élément avec la clé spécifiée. (Hérité de DbConnectionStringBuilder.)
Implémentation d'interface expliciteMéthode privéeIDictionary.GetEnumeratorRetourne un objet IDictionaryEnumerator pour l'objet IDictionary. (Hérité de DbConnectionStringBuilder.)
Implémentation d'interface explicitePropriété privéeIDictionary.ItemObtient ou définit l'élément avec la clé spécifiée. (Hérité de DbConnectionStringBuilder.)
Implémentation d'interface expliciteMéthode privéeIDictionary.RemoveSupprime de l'objet IDictionary l'élément ayant la clé spécifiée. (Hérité de DbConnectionStringBuilder.)
Implémentation d'interface expliciteMéthode privéeIEnumerable.GetEnumeratorRetourne un énumérateur qui itère au sein d'une collection. (Hérité de DbConnectionStringBuilder.)
Début

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 portant sur 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.

RemarqueRemarque

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.

L'exemple suivant montre comment utiliser EntityConnectionStringBuilder avec 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();
}


.NET Framework

Pris en charge dans : 4.5.2, 4.5.1, 4.5, 4, 3.5 SP1

.NET Framework Client Profile

Pris en charge dans : 4

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (rôle principal du serveur non pris en charge), Windows Server 2008 R2 (rôle principal du serveur pris en charge avec SP1 ou version ultérieure ; Itanium non pris en charge)

Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

Tous les membres static (Shared en Visual Basic) publics de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

Ajouts de la communauté

AJOUTER
Afficher:
© 2014 Microsoft