EntityConnectionStringBuilder Clase

Definición

Espacio de nombres:

System.Data.EntityClient

Ensamblado:

System.Data.Entity.dll

Proporciona una manera sencilla de crear y administrar el contenido de las cadenas de conexión usadas por 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

Herencia

Object

DbConnectionStringBuilder

EntityConnectionStringBuilder

Ejemplos

En el ejemplo siguiente se muestra cómo usar junto EntityConnectionStringBuilder con .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

Comentarios

El generador de cadenas de conexión permite a los programadores crear cadenas de conexión sintácticasmente correctas y analizar y recompilar las cadenas de conexión existentes mediante propiedades y métodos de la clase . El generador de cadenas de conexión proporciona propiedades fuertemente tipadas correspondientes a los pares de palabra clave y valor conocidos. Los desarrolladores que deben crear cadenas de conexión como parte de las aplicaciones pueden usar la EntityConnectionStringBuilder clase para compilar y modificar cadenas de conexión.

EntityConnectionStringBuilder realiza comprobaciones de pares válidos de palabra clave-valor, cada uno de los cuales se expone como un EntityConnectionStringBuilder valor de propiedad.

Nota:

La propiedad proporciona la ProviderConnectionString cadena de conexión para el origen de datos subyacente. La cadena de conexión del proveedor proporcionada no se comprueba si hay pares válidos de palabra clave/valor.

Constructores

Nombre	Description
EntityConnectionStringBuilder()	Inicializa una nueva instancia de la clase EntityConnectionStringBuilder.
EntityConnectionStringBuilder(String)	Inicializa una nueva instancia de la EntityConnectionStringBuilder clase utilizando la cadena de conexión proporcionada.

Propiedades

Nombre	Description
BrowsableConnectionString	Obtiene o establece un valor que indica si la ConnectionString propiedad está visible en los diseñadores de Visual Studio. (Heredado de DbConnectionStringBuilder)
ConnectionString	Obtiene o establece la cadena de conexión asociada a .DbConnectionStringBuilder (Heredado de DbConnectionStringBuilder)
Count	Obtiene el número actual de claves contenidas en la ConnectionString propiedad . (Heredado de DbConnectionStringBuilder)
IsFixedSize	Obtiene un valor que indica si EntityConnectionStringBuilder tiene un tamaño fijo.
IsReadOnly	Obtiene un valor que indica si es DbConnectionStringBuilder de solo lectura. (Heredado de DbConnectionStringBuilder)
Item[String]	Obtiene o establece el valor asociado a la clave especificada. En C#, esta propiedad es el indexador.
Keys	Obtiene un ICollection objeto que contiene las claves de .EntityConnectionStringBuilder
Metadata	Obtiene o establece las ubicaciones de metadatos en la cadena de conexión.
Name	Obtiene o establece el nombre de una sección tal como se define en un archivo de configuración.
Provider	Obtiene o establece el nombre del proveedor de datos subyacente de .NET Framework en la cadena de conexión.
ProviderConnectionString	Obtiene o establece la cadena de conexión interna específica del proveedor.
Values	Obtiene un ICollection objeto que contiene los valores de .DbConnectionStringBuilder (Heredado de DbConnectionStringBuilder)

Métodos

Nombre	Description
Add(String, Object)	Agrega una entrada con la clave y el valor especificados en .DbConnectionStringBuilder (Heredado de DbConnectionStringBuilder)
Clear()	Borra el contenido de la EntityConnectionStringBuilder instancia.
ClearPropertyDescriptors()	Borra la colección de PropertyDescriptor objetos en el objeto asociado DbConnectionStringBuilder. (Heredado de DbConnectionStringBuilder)
ContainsKey(String)	Determina si contiene EntityConnectionStringBuilder una clave específica.
Equals(Object)	Determina si el objeto especificado es igual al objeto actual. (Heredado de Object)
EquivalentTo(DbConnectionStringBuilder)	Compara la información de conexión de este DbConnectionStringBuilder objeto con la información de conexión del objeto proporcionado. (Heredado de DbConnectionStringBuilder)
GetHashCode()	Actúa como función hash predeterminada. (Heredado de Object)
GetProperties(Hashtable)	Rellena un proporcionado Hashtable con información sobre todas las propiedades de este DbConnectionStringBuilder. (Heredado de DbConnectionStringBuilder)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
MemberwiseClone()	Crea una copia superficial del Objectactual. (Heredado de Object)
Remove(String)	Quita la entrada con la clave especificada de la EntityConnectionStringBuilder instancia.
ShouldSerialize(String)	Indica si la clave especificada existe en esta DbConnectionStringBuilder instancia. (Heredado de DbConnectionStringBuilder)
ToString()	Devuelve la cadena de conexión asociada a este DbConnectionStringBuilder. (Heredado de DbConnectionStringBuilder)
TryGetValue(String, Object)	Recupera un valor correspondiente a la clave proporcionada de este EntityConnectionStringBuilder.

Implementaciones de interfaz explícitas

Nombre	Description
ICollection.CopyTo(Array, Int32)	Copia los elementos de en ICollection un Arrayobjeto , comenzando en un índice determinado Array . (Heredado de DbConnectionStringBuilder)
ICollection.IsSynchronized	Obtiene un valor que indica si el acceso a ICollection está sincronizado (seguro para subprocesos). (Heredado de DbConnectionStringBuilder)
ICollection.SyncRoot	Obtiene un objeto que se puede usar para sincronizar el acceso a .ICollection (Heredado de DbConnectionStringBuilder)
ICustomTypeDescriptor.GetAttributes()	Devuelve una colección de atributos personalizados para esta instancia de un componente. (Heredado de DbConnectionStringBuilder)
ICustomTypeDescriptor.GetClassName()	Devuelve el nombre de clase de esta instancia de un componente. (Heredado de DbConnectionStringBuilder)
ICustomTypeDescriptor.GetComponentName()	Devuelve el nombre de esta instancia de un componente. (Heredado de DbConnectionStringBuilder)
ICustomTypeDescriptor.GetConverter()	Devuelve un convertidor de tipos para esta instancia de un componente. (Heredado de DbConnectionStringBuilder)
ICustomTypeDescriptor.GetDefaultEvent()	Devuelve el evento predeterminado para esta instancia de un componente. (Heredado de DbConnectionStringBuilder)
ICustomTypeDescriptor.GetDefaultProperty()	Devuelve la propiedad predeterminada para esta instancia de un componente. (Heredado de DbConnectionStringBuilder)
ICustomTypeDescriptor.GetEditor(Type)	Devuelve un editor del tipo especificado para esta instancia de un componente. (Heredado de DbConnectionStringBuilder)
ICustomTypeDescriptor.GetEvents()	Devuelve los eventos de esta instancia de un componente. (Heredado de DbConnectionStringBuilder)
ICustomTypeDescriptor.GetEvents(Attribute[])	Devuelve los eventos de esta instancia de un componente mediante la matriz de atributos especificada como filtro. (Heredado de DbConnectionStringBuilder)
ICustomTypeDescriptor.GetProperties()	Devuelve las propiedades de esta instancia de un componente. (Heredado de DbConnectionStringBuilder)
ICustomTypeDescriptor.GetProperties(Attribute[])	Devuelve las propiedades de esta instancia de un componente mediante la matriz de atributos como filtro. (Heredado de DbConnectionStringBuilder)
ICustomTypeDescriptor.GetPropertyOwner(PropertyDescriptor)	Devuelve un objeto que contiene la propiedad descrita por el descriptor de propiedad especificado. (Heredado de DbConnectionStringBuilder)
IDictionary.Add(Object, Object)	Agrega un elemento con la clave y el valor proporcionados al IDictionary objeto . (Heredado de DbConnectionStringBuilder)
IDictionary.Contains(Object)	Determina si el IDictionary objeto contiene un elemento con la clave especificada. (Heredado de DbConnectionStringBuilder)
IDictionary.GetEnumerator()	Devuelve un IDictionaryEnumerator objeto para el IDictionary objeto . (Heredado de DbConnectionStringBuilder)
IDictionary.Item[Object]	Obtiene o establece el elemento con la clave especificada. (Heredado de DbConnectionStringBuilder)
IDictionary.Remove(Object)	Quita el elemento con la clave especificada del IDictionary objeto . (Heredado de DbConnectionStringBuilder)
IEnumerable.GetEnumerator()	Devuelve un enumerador que recorre en iteración una colección. (Heredado de DbConnectionStringBuilder)

Métodos de extensión

Nombre	Description
AsParallel(IEnumerable)	Habilita la paralelización de una consulta.
AsQueryable(IEnumerable)	Convierte un IEnumerable en un IQueryable.
Cast<TResult>(IEnumerable)	Convierte los elementos de un IEnumerable al tipo especificado.
OfType<TResult>(IEnumerable)	Filtra los elementos de un IEnumerable en función de un tipo especificado.

Consulte también

• EntityConnection
• Cadenas de conexión
• Trabajar con EntityClient