SqlConnectionStringBuilder SqlConnectionStringBuilder SqlConnectionStringBuilder SqlConnectionStringBuilder Class

Definizione

Fornisce un mezzo per creare e gestire facilmente il contenuto delle stringhe di connessione utilizzate dalla classe SqlConnection.Provides a simple way to create and manage the contents of connection strings used by the SqlConnection class.

public ref class SqlConnectionStringBuilder sealed : System::Data::Common::DbConnectionStringBuilder
[System.ComponentModel.TypeConverter(typeof(System.Data.SqlClient.SqlConnectionStringBuilder/SqlConnectionStringBuilderConverter))]
public sealed class SqlConnectionStringBuilder : System.Data.Common.DbConnectionStringBuilder
type SqlConnectionStringBuilder = class
    inherit DbConnectionStringBuilder
Public NotInheritable Class SqlConnectionStringBuilder
Inherits DbConnectionStringBuilder
Ereditarietà
SqlConnectionStringBuilderSqlConnectionStringBuilderSqlConnectionStringBuilderSqlConnectionStringBuilder
Attributi

Esempi

La seguente applicazione console crea le stringhe di connessione per un database di SQL Server.The following console application builds connection strings for a SQL Server database. Il codice utilizza una classe SqlConnectionStringBuilder per creare la stringa di connessione e quindi passa la proprietà ConnectionString dell'istanza SqlConnectionStringBuilder al costruttore della classe di connessione.The code uses a SqlConnectionStringBuilder class to create the connection string, and then passes the ConnectionString property of the SqlConnectionStringBuilder instance to the constructor of the connection class. L'esempio inoltre analizza una stringa di connessione esistente e dimostra modi diversi di manipolare i contenuti della stringa di connessione.The example also parses an existing connection string and demonstrates various ways of manipulating the connection string's contents.

Nota

In questo esempio è inclusa una password per dimostrare il funzionamento di SqlConnectionStringBuilder con le stringhe di connessione.This example includes a password to demonstrate how SqlConnectionStringBuilder works with connection strings. Nelle applicazioni, è consigliabile utilizzare Windows Authentication.In your applications, we recommend that you use Windows Authentication. Quando è necessario utilizzare una password, non includere password hardcoded nell'applicazione.If you must use a password, do not include a hard-coded password in your application.

using System.Data;
using System.Data.SqlClient;

class Program
{
    static void Main()
    {
        // Create a new SqlConnectionStringBuilder and
        // initialize it with a few name/value pairs.
        SqlConnectionStringBuilder builder =
            new SqlConnectionStringBuilder(GetConnectionString());

        // The input connection string used the 
        // Server key, but the new connection string uses
        // the well-known Data Source key instead.
        Console.WriteLine(builder.ConnectionString);

        // Pass the SqlConnectionStringBuilder an existing 
        // connection string, and you can retrieve and
        // modify any of the elements.
        builder.ConnectionString = "server=(local);user id=ab;" +
            "password= a!Pass113;initial catalog=AdventureWorks";

        // Now that the connection string has been parsed,
        // you can work with individual items.
        Console.WriteLine(builder.Password);
        builder.Password = "new@1Password";
        builder.AsynchronousProcessing = true;

        // You can refer to connection keys using strings, 
        // as well. When you use this technique (the default
        // Item property in Visual Basic, or the indexer in C#),
        // you can specify any synonym for the connection string key
        // name.
        builder["Server"] = ".";
        builder["Connect Timeout"] = 1000;
        builder["Trusted_Connection"] = true;
        Console.WriteLine(builder.ConnectionString);

        Console.WriteLine("Press Enter to finish.");
        Console.ReadLine();
    }

    private static string GetConnectionString()
    {
        // To avoid storing the connection string in your code,
        // you can retrieve it from a configuration file. 
        return "Server=(local);Integrated Security=SSPI;" +
            "Initial Catalog=AdventureWorks";
    }
}
Imports System.Data.SqlClient

Module Module1
    Sub Main()
        ' Create a new SqlConnectionStringBuilder and
        ' initialize it with a few name/value pairs:
        Dim builder As New SqlConnectionStringBuilder(GetConnectionString())

        ' The input connection string used the 
        ' Server key, but the new connection string uses
        ' the well-known Data Source key instead.
        Console.WriteLine(builder.ConnectionString)

        ' Pass the SqlConnectionStringBuilder an existing 
        ' connection string, and you can retrieve and
        ' modify any of the elements.
        builder.ConnectionString = _
            "server=(local);user id=ab;" & _
            "password=a!Pass113;initial catalog=AdventureWorks"
        ' Now that the connection string has been parsed,
        ' you can work with individual items.
        Console.WriteLine(builder.Password)
        builder.Password = "new@1Password"
        builder.AsynchronousProcessing = True

        ' You can refer to connection keys using strings, 
        ' as well. When you use this technique (the default
        ' Item property in Visual Basic, or the indexer in C#)
        ' you can specify any synonym for the connection string key
        ' name.
        builder("Server") = "."
        builder("Connect Timeout") = 1000

        ' The Item property is the default for the class, 
        ' and setting the Item property adds the value to the 
        ' dictionary, if necessary. 
        builder.Item("Trusted_Connection") = True
        Console.WriteLine(builder.ConnectionString)

        Console.WriteLine("Press Enter to finish.")
        Console.ReadLine()
    End Sub

    Private Function GetConnectionString() As String
        ' To avoid storing the connection string in your code,
        ' you can retrieve it from a configuration file. 
        Return "Server=(local);Integrated Security=SSPI;" & _
          "Initial Catalog=AdventureWorks"
    End Function
End Module

Commenti

Il generatore di stringhe di connessione consente agli sviluppatori di creare a livello di codice stringhe di connessione sintatticamente corrette, nonché di analizzare e ricompilare le stringhe di connessione esistenti, utilizzando le proprietà e i metodi della classe.The connection string builder lets developers programmatically create syntactically correct connection strings, and parse and rebuild existing connection strings, using properties and methods of the class. Il generatore di stringhe di connessione fornisce proprietà fortemente tipizzate corrispondenti alle coppie chiave/valore note consentite da SQL Server.The connection string builder provides strongly typed properties corresponding to the known key/value pairs allowed by SQL Server. Gli sviluppatori che devono creare stringhe di connessione come parte delle applicazioni possono utilizzare la classe SqlConnectionStringBuilder per compilare e modificare tali stringhe.Developers needing to create connection strings as part of applications can use the SqlConnectionStringBuilder class to build and modify connection strings. La classe rende facile la gestione delle stringhe di connessione memorizzate nel file di configurazione dell'applicazione.The class also makes it easy to manage connection strings stored in an application configuration file.

L'oggetto SqlConnectionStringBuilder non esegue alcuna verifica sulla validità delle coppie chiave/valore.The SqlConnectionStringBuilder performs checks for valid key/value pairs. Di conseguenza, non è possibile utilizzare questa classe per creare stringhe di connessione non valide; provando ad aggiungere coppie non valide verrà rilevata un'eccezione.Therefore, you cannot use this class to create invalid connection strings; trying to add invalid pairs will throw an exception. La classe gestisce una raccolta fissa di sinonimi e può essere convertita da un sinonimo al nome della chiave noto.The class maintains a fixed collection of synonyms and can translate from a synonym to the corresponding well-known key name.

Ad esempio, quando si usa la elemento proprietà per recuperare un valore, è possibile specificare una stringa che contiene un sinonimo per la chiave necessaria.For example, when you use the Item property to retrieve a value, you can specify a string that contains any synonym for the key you need. Ad esempio, è possibile specificare "Network Address", "addr" o qualsiasi altro sinonimo accettabile per questa chiave all'interno di una stringa di connessione quando si utilizza il membro che richiede una stringa che contiene il nome della chiave, ad esempio la elemento proprietà o il Remove (metodo).For example, you can specify "Network Address", "addr", or any other acceptable synonym for this key within a connection string when you use any member that requires a string that contains the key name, such as the Item property or the Remove method. Per un elenco completo di sinonimo accettabili, vedere la proprietà ConnectionString.See the ConnectionString property for a full list of acceptable synonyms.

Il elemento proprietà gestisce i tentativi di inserire le voci nocive.The Item property handles tries to insert malicious entries. Ad esempio, il seguente codice che utilizza la proprietà Item predefinita (l'indicizzatore, in C#) esegue l'escape dalla coppia chiave/valore annidata.For example, the following code, using the default Item property (the indexer, in C#) correctly escapes the nested key/value pair:

Dim builder As New System.Data.SqlClient.SqlConnectionStringBuilder  
builder("Data Source") = "(local)"  
builder("Integrated Security") = True  
builder("Initial Catalog") = "AdventureWorks;NewValue=Bad"  
Console.WriteLine(builder.ConnectionString)  
System.Data.SqlClient.SqlConnectionStringBuilder builder =  
  new System.Data.SqlClient.SqlConnectionStringBuilder();  
builder["Data Source"] = "(local)";  
builder["integrated Security"] = true;  
builder["Initial Catalog"] = "AdventureWorks;NewValue=Bad";  
Console.WriteLine(builder.ConnectionString);  

Il risultato è la seguente stringa di connessione che gestisce il valore non valido in modo sicuro:The result is the following connection string that handles the invalid value in a safe manner:

Source=(local);Initial Catalog="AdventureWorks;NewValue=Bad";  
Integrated Security=True  

Costruttori

SqlConnectionStringBuilder() SqlConnectionStringBuilder() SqlConnectionStringBuilder() SqlConnectionStringBuilder()

Inizializza una nuova istanza della classe SqlConnectionStringBuilder.Initializes a new instance of the SqlConnectionStringBuilder class.

SqlConnectionStringBuilder(String) SqlConnectionStringBuilder(String) SqlConnectionStringBuilder(String) SqlConnectionStringBuilder(String)

Inizializza una nuova istanza della classe SqlConnectionStringBuilder.Initializes a new instance of the SqlConnectionStringBuilder class. La stringa di connessione indicata fornisce i dati per le informazioni di connessione interne dell'istanza.The provided connection string provides the data for the instance's internal connection information.

Proprietà

ApplicationIntent ApplicationIntent ApplicationIntent ApplicationIntent

Dichiara il tipo di carico di lavoro dell'applicazione durante la connessione a un database in un gruppo di disponibilità SQL Server.Declares the application workload type when connecting to a database in an SQL Server Availability Group. È possibile impostare il valore di questa proprietà con ApplicationIntent.You can set the value of this property with ApplicationIntent. Per altre informazioni sul supporto SqlClient per gruppi di disponibilità Always On, vedere Supporto SqlClient per disponibilità elevata, ripristino di emergenza.For more information about SqlClient support for Always On Availability Groups, see SqlClient Support for High Availability, Disaster Recovery.

ApplicationName ApplicationName ApplicationName ApplicationName

Ottiene o imposta il nome dell'applicazione associata alla stringa di connessione.Gets or sets the name of the application associated with the connection string.

AsynchronousProcessing AsynchronousProcessing AsynchronousProcessing AsynchronousProcessing

Ottiene o imposta un valore booleano che indica se l'elaborazione asincrona è consentita dalla connessione creata mediante questa stringa di connessione.Gets or sets a Boolean value that indicates whether asynchronous processing is allowed by the connection created by using this connection string.

AttachDBFilename AttachDBFilename AttachDBFilename AttachDBFilename

Ottiene o imposta una stringa contenente il nome del file di dati primario.Gets or sets a string that contains the name of the primary data file. Questo include il nome completo del percorso di un database a cui è possibile collegarsi.This includes the full path name of an attachable database.

Authentication Authentication Authentication Authentication

Ottiene l'autenticazione della stringa di connessione.Gets the authentication of the connection string.

BrowsableConnectionString BrowsableConnectionString BrowsableConnectionString BrowsableConnectionString

Ottiene o imposta un valore che indica se la proprietà ConnectionString è visibile nelle finestre di progettazione di Visual Studio.Gets or sets a value that indicates whether the ConnectionString property is visible in Visual Studio designers.

(Inherited from DbConnectionStringBuilder)
ColumnEncryptionSetting ColumnEncryptionSetting ColumnEncryptionSetting ColumnEncryptionSetting

Ottiene o imposta le impostazioni di crittografia di colonna per il compilatore di stringhe di connessione.Gets or sets the column encryption settings for the connection string builder.

ConnectionReset ConnectionReset ConnectionReset ConnectionReset

Obsoleta.Obsolete. Ottiene o imposta un valore booleano che indica se la connessione viene reimpostata quando viene creata dal pool di connessioni.Gets or sets a Boolean value that indicates whether the connection is reset when drawn from the connection pool.

ConnectionString ConnectionString ConnectionString ConnectionString

Ottiene o imposta la stringa di connessione associata all'oggetto DbConnectionStringBuilder.Gets or sets the connection string associated with the DbConnectionStringBuilder.

(Inherited from DbConnectionStringBuilder)
ConnectRetryCount ConnectRetryCount ConnectRetryCount ConnectRetryCount

Numero di riconnessioni tentate dopo aver identificato un errore di connessione inattiva.The number of reconnections attempted after identifying that there was an idle connection failure. Deve essere un valore Integer compreso tra 0 e 255.This must be an integer between 0 and 255. Il valore predefinito è 1.Default is 1. Impostare su 0 per disattivare la riconnessione per gli errori di connessione inattiva.Set to 0 to disable reconnecting on idle connection failures. Verrà generata un'eccezione ArgumentException se è impostato su un valore non compreso nell'intervallo consentito.An ArgumentException will be thrown if set to a value outside of the allowed range.

ConnectRetryInterval ConnectRetryInterval ConnectRetryInterval ConnectRetryInterval

Periodo di tempo (in secondi) tra ogni tentativo di riconnessione dopo che è stato identificato un errore di connessione inattiva.Amount of time (in seconds) between each reconnection attempt after identifying that there was an idle connection failure. Deve essere un numero intero compreso tra 1 e 60.This must be an integer between 1 and 60. Il valore predefinito è 10 secondi.The default is 10 seconds. Verrà generata un'eccezione ArgumentException se è impostato su un valore non compreso nell'intervallo consentito.An ArgumentException will be thrown if set to a value outside of the allowed range.

ConnectTimeout ConnectTimeout ConnectTimeout ConnectTimeout

Ottiene o imposta il tempo di attesa (in secondi) di una connessione al server prima che il tentativo sia terminato e venga generato un errore.Gets or sets the length of time (in seconds) to wait for a connection to the server before terminating the attempt and generating an error.

ContextConnection ContextConnection ContextConnection ContextConnection

Ottiene o imposta un valore che indica se effettuare una connessione di tipo client/server o in-process a SQL Server.Gets or sets a value that indicates whether a client/server or in-process connection to SQL Server should be made.

Count Count Count Count

Ottiene il numero corrente di chiavi contenute all'interno della proprietà ConnectionString.Gets the current number of keys that are contained within the ConnectionString property.

(Inherited from DbConnectionStringBuilder)
CurrentLanguage CurrentLanguage CurrentLanguage CurrentLanguage

Ottiene o imposta il nome del record della lingua SQL Server.Gets or sets the SQL Server Language record name.

DataSource DataSource DataSource DataSource

Ottiene o imposta il nome o l'indirizzo di rete dell'istanza di SQL Server a cui connettersi.Gets or sets the name or network address of the instance of SQL Server to connect to.

EnclaveAttestationUrl EnclaveAttestationUrl EnclaveAttestationUrl EnclaveAttestationUrl

Ottiene o imposta l'URL di attestazione enclave da usare con Always Encrypted basata su enclave.Gets or sets the enclave attestation Url to be used with enclave based Always Encrypted.

Encrypt Encrypt Encrypt Encrypt

Ottiene o imposta un valore booleano che indica se SQL Server utilizza la crittografia SSL per tutti i dati inviati tra client e server, se nel server è installato un certificato.Gets or sets a Boolean value that indicates whether SQL Server uses SSL encryption for all data sent between the client and server if the server has a certificate installed.

Enlist Enlist Enlist Enlist

Ottiene o imposta un valore booleano che indica se il pool di connessioni SQL Server inserisce automaticamente la connessione nel contesto della transazione corrente del thread di creazione.Gets or sets a Boolean value that indicates whether the SQL Server connection pooler automatically enlists the connection in the creation thread's current transaction context.

FailoverPartner FailoverPartner FailoverPartner FailoverPartner

Ottiene o imposta il nome o l'indirizzo del server partner al quale connettersi se il server primario è spento.Gets or sets the name or address of the partner server to connect to if the primary server is down.

ICollection.IsSynchronized ICollection.IsSynchronized ICollection.IsSynchronized ICollection.IsSynchronized

Ottiene un valore che indica se l'accesso a ICollection è sincronizzato (thread-safe).Gets a value indicating whether access to the ICollection is synchronized (thread safe).

(Inherited from DbConnectionStringBuilder)
ICollection.SyncRoot ICollection.SyncRoot ICollection.SyncRoot ICollection.SyncRoot

Ottiene un oggetto che può essere usato per sincronizzare l'accesso a ICollection.Gets an object that can be used to synchronize access to the ICollection.

(Inherited from DbConnectionStringBuilder)
IDictionary.IsFixedSize IDictionary.IsFixedSize IDictionary.IsFixedSize IDictionary.IsFixedSize Inherited from DbConnectionStringBuilder
IDictionary.IsReadOnly IDictionary.IsReadOnly IDictionary.IsReadOnly IDictionary.IsReadOnly Inherited from DbConnectionStringBuilder
IDictionary.Item[Object] IDictionary.Item[Object] IDictionary.Item[Object] IDictionary.Item[Object]

Ottiene o imposta l'elemento con la chiave specificata.Gets or sets the element with the specified key.

(Inherited from DbConnectionStringBuilder)
InitialCatalog InitialCatalog InitialCatalog InitialCatalog

Ottiene o imposta il nome del database associato alla connessione.Gets or sets the name of the database associated with the connection.

IntegratedSecurity IntegratedSecurity IntegratedSecurity IntegratedSecurity

Ottiene o imposta un valore booleano che indica se sono specificati ID utente e Password nella connessione (quando è false) o se sono usate le credenziali di account Windows correnti per l'autenticazione (quando è true).Gets or sets a Boolean value that indicates whether User ID and Password are specified in the connection (when false) or whether the current Windows account credentials are used for authentication (when true).

IsFixedSize IsFixedSize IsFixedSize IsFixedSize

Ottiene un valore che indica se le dimensioni dell'oggetto SqlConnectionStringBuilder sono fisse.Gets a value that indicates whether the SqlConnectionStringBuilder has a fixed size.

IsReadOnly IsReadOnly IsReadOnly IsReadOnly

Ottiene un valore che indica se DbConnectionStringBuilder è in sola lettura.Gets a value that indicates whether the DbConnectionStringBuilder is read-only.

(Inherited from DbConnectionStringBuilder)
Item[String] Item[String] Item[String] Item[String]

Ottiene o imposta il valore associato alla chiave specificata.Gets or sets the value associated with the specified key. In C# questa proprietà è l'indicizzatore.In C#, this property is the indexer.

Keys Keys Keys Keys

Ottiene un oggetto ICollection che contiene le chiavi presenti in SqlConnectionStringBuilder.Gets an ICollection that contains the keys in the SqlConnectionStringBuilder.

LoadBalanceTimeout LoadBalanceTimeout LoadBalanceTimeout LoadBalanceTimeout

Ottiene o imposta il tempo minimo, espresso in secondi, di permanenza della connessione nel pool prima di essere eliminata.Gets or sets the minimum time, in seconds, for the connection to live in the connection pool before being destroyed.

MaxPoolSize MaxPoolSize MaxPoolSize MaxPoolSize

Ottiene o imposta il numero massimo di connessioni consentite nel pool di connessioni per la stringa di connessione specificata.Gets or sets the maximum number of connections allowed in the connection pool for this specific connection string.

MinPoolSize MinPoolSize MinPoolSize MinPoolSize

Ottiene o imposta il numero minimo di connessioni consentite nel pool di connessioni per la stringa di connessione specificata.Gets or sets the minimum number of connections allowed in the connection pool for this specific connection string.

MultipleActiveResultSets MultipleActiveResultSets MultipleActiveResultSets MultipleActiveResultSets

Se true, l'applicazione può gestire la funzionalità MARS (Multiple Active Result Set).When true, an application can maintain multiple active result sets (MARS). Se false, l'applicazione deve elaborare o annullare tutti i set di risultati di un batch prima di poter eseguire qualsiasi altro batch nella connessione.When false, an application must process or cancel all result sets from one batch before it can execute any other batch on that connection.

Per altre informazioni, vedere MARS (Multiple Active Result Sets).For more information, see Multiple Active Result Sets (MARS).

MultiSubnetFailover MultiSubnetFailover MultiSubnetFailover MultiSubnetFailover

Se l'applicazione si sta connettendo ad un gruppo di disponibilità AlwaysOn su diverse subnet, impostando MultiSubnetFailover=true viene fornito un rilevamento più veloce e una connessione al server (al momento) attivo.If your application is connecting to an AlwaysOn availability group (AG) on different subnets, setting MultiSubnetFailover=true provides faster detection of and connection to the (currently) active server. Per altre informazioni sul supporto SqlClient per gruppi di disponibilità Always On, vedere Supporto SqlClient per disponibilità elevata, ripristino di emergenza.For more information about SqlClient support for Always On Availability Groups, see SqlClient Support for High Availability, Disaster Recovery.

NetworkLibrary NetworkLibrary NetworkLibrary NetworkLibrary

Ottiene o imposta una stringa contenente il nome della libreria di rete utilizzata per stabilire una connessione a SQL Server.Gets or sets a string that contains the name of the network library used to establish a connection to the SQL Server.

PacketSize PacketSize PacketSize PacketSize

Ottiene o imposta le dimensioni in byte dei pacchetti di rete utilizzati per comunicare con un'istanza di SQL Server.Gets or sets the size in bytes of the network packets used to communicate with an instance of SQL Server.

Password Password Password Password

Ottiene o imposta la password per l'account di SQL Server.Gets or sets the password for the SQL Server account.

PersistSecurityInfo PersistSecurityInfo PersistSecurityInfo PersistSecurityInfo

Ottiene o imposta un valore booleano che indica se le informazioni sensibili alla sicurezza, quali la password, non vengono restituite come parte della connessione se quest'ultima è aperta o è già stata aperta.Gets or sets a Boolean value that indicates if security-sensitive information, such as the password, is not returned as part of the connection if the connection is open or has ever been in an open state.

PoolBlockingPeriod PoolBlockingPeriod PoolBlockingPeriod PoolBlockingPeriod

Comportamento del periodo di blocco di un pool di connessioni.The blocking period behavior for a connection pool.

Pooling Pooling Pooling Pooling

Ottiene o imposta un valore booleano che indica se verrà effettuato il pool della connessione o se questa verrà aperta esplicitamente ad ogni richiesta.Gets or sets a Boolean value that indicates whether the connection will be pooled or explicitly opened every time that the connection is requested.

Replication Replication Replication Replication

Ottiene o imposta un valore booleano che indica se, utilizzando la connessione, è supportata la replica.Gets or sets a Boolean value that indicates whether replication is supported using the connection.

TransactionBinding TransactionBinding TransactionBinding TransactionBinding

Ottiene o imposta un valore stringa che indica il modo in cui la connessione gestisce l'associazione a una transazione System.Transactions integrata.Gets or sets a string value that indicates how the connection maintains its association with an enlisted System.Transactions transaction.

TransparentNetworkIPResolution TransparentNetworkIPResolution TransparentNetworkIPResolution TransparentNetworkIPResolution

Quando il valore di questa chiave è impostato su true, l'applicazione deve recuperare tutti gli indirizzi IP per una particolare voce DNS e tentare la connessione al primo nell'elenco.When the value of this key is set to true, the application is required to retrieve all IP addresses for a particular DNS entry and attempt to connect with the first one in the list. Se la connessione non viene stabilita entro 0,5 secondi, l'applicazione tenterà di connettersi a tutti gli altri in parallelo.If the connection is not established within 0.5 seconds, the application will try to connect to all others in parallel. Quando il primo risponde, l'applicazione stabilirà la connessione con l'indirizzo IP che ha risposto.When the first answers, the application will establish the connection with the respondent IP address.

TrustServerCertificate TrustServerCertificate TrustServerCertificate TrustServerCertificate

Ottiene o imposta un valore che indica se il canale è crittografato mentre viene ignorata l'analisi della catena di certificati per convalidare l'attendibilità.Gets or sets a value that indicates whether the channel will be encrypted while bypassing walking the certificate chain to validate trust.

TypeSystemVersion TypeSystemVersion TypeSystemVersion TypeSystemVersion

Ottiene o imposta un valore stinga che indica il sistema dei tipi previsto per l'applicazione.Gets or sets a string value that indicates the type system the application expects.

UserID UserID UserID UserID

Ottiene o imposta l'ID utente da utilizzare per la connessione a SQL Server.Gets or sets the user ID to be used when connecting to SQL Server.

UserInstance UserInstance UserInstance UserInstance

Ottiene o imposta un valore che indica se reindirizzare la connessione dall'istanza predefinita di SQL Server Express all'istanza avviata in fase di esecuzione ed eseguita con l'account del chiamante.Gets or sets a value that indicates whether to redirect the connection from the default SQL Server Express instance to a runtime-initiated instance running under the account of the caller.

Values Values Values Values

Ottiene un oggetto ICollection contenente i valori di SqlConnectionStringBuilder.Gets an ICollection that contains the values in the SqlConnectionStringBuilder.

WorkstationID WorkstationID WorkstationID WorkstationID

Ottiene o imposta il nome della workstation connessa a SQL Server.Gets or sets the name of the workstation connecting to SQL Server.

Metodi

Add(String, Object) Add(String, Object) Add(String, Object) Add(String, Object)

Aggiunge una voce con la chiave e il valore specificati all'interno dell'interfaccia DbConnectionStringBuilder.Adds an entry with the specified key and value into the DbConnectionStringBuilder.

(Inherited from DbConnectionStringBuilder)
Clear() Clear() Clear() Clear()

Cancella il contenuto dell'istanza di SqlConnectionStringBuilder.Clears the contents of the SqlConnectionStringBuilder instance.

ClearPropertyDescriptors() ClearPropertyDescriptors() ClearPropertyDescriptors() ClearPropertyDescriptors()

Cancella la raccolta di oggetti PropertyDescriptor per l'oggetto DbConnectionStringBuilder associato.Clears the collection of PropertyDescriptor objects on the associated DbConnectionStringBuilder.

(Inherited from DbConnectionStringBuilder)
ContainsKey(String) ContainsKey(String) ContainsKey(String) ContainsKey(String)

Determina se l'oggetto SqlConnectionStringBuilder contiene una chiave specifica.Determines whether the SqlConnectionStringBuilder contains a specific key.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Inherited from Object)
EquivalentTo(DbConnectionStringBuilder) EquivalentTo(DbConnectionStringBuilder) EquivalentTo(DbConnectionStringBuilder) EquivalentTo(DbConnectionStringBuilder)

Confronta le informazioni sulla connessione in questo oggetto DbConnectionStringBuilder con le informazioni sulla connessione nell'oggetto fornito.Compares the connection information in this DbConnectionStringBuilder object with the connection information in the supplied object.

(Inherited from DbConnectionStringBuilder)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Inherited from Object)
GetProperties(Hashtable) GetProperties(Hashtable) GetProperties(Hashtable) GetProperties(Hashtable)

Riempie una classe Hashtable fornita con informazioni su tutte le proprietà di questa classe DbConnectionStringBuilder.Fills a supplied Hashtable with information about all the properties of this DbConnectionStringBuilder.

(Inherited from DbConnectionStringBuilder)
GetType() GetType() GetType() GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Inherited from Object)
Remove(String) Remove(String) Remove(String) Remove(String)

Rimuove la voce con la chiave specificata dall'istanza di SqlConnectionStringBuilder.Removes the entry with the specified key from the SqlConnectionStringBuilder instance.

ShouldSerialize(String) ShouldSerialize(String) ShouldSerialize(String) ShouldSerialize(String)

Indica se la chiave specificata esiste in questa istanza SqlConnectionStringBuilder.Indicates whether the specified key exists in this SqlConnectionStringBuilder instance.

ToString() ToString() ToString() ToString()

Restituisce la stringa di connessione associata a questa classe DbConnectionStringBuilder.Returns the connection string associated with this DbConnectionStringBuilder.

(Inherited from DbConnectionStringBuilder)
TryGetValue(String, Object) TryGetValue(String, Object) TryGetValue(String, Object) TryGetValue(String, Object)

Recupera un valore che corrisponde alla chiave fornita da questo oggetto SqlConnectionStringBuilder.Retrieves a value corresponding to the supplied key from this SqlConnectionStringBuilder.

Implementazioni dell'interfaccia esplicita

ICollection.CopyTo(Array, Int32) ICollection.CopyTo(Array, Int32) ICollection.CopyTo(Array, Int32) ICollection.CopyTo(Array, Int32)

Copia gli elementi di ICollection in Array a partire da un particolare indice Array.Copies the elements of the ICollection to an Array, starting at a particular Array index.

(Inherited from DbConnectionStringBuilder)
ICustomTypeDescriptor.GetAttributes() ICustomTypeDescriptor.GetAttributes() ICustomTypeDescriptor.GetAttributes() ICustomTypeDescriptor.GetAttributes()

Restituisce un insieme di attributi personalizzati per questa istanza di un componente.Returns a collection of custom attributes for this instance of a component.

(Inherited from DbConnectionStringBuilder)
ICustomTypeDescriptor.GetClassName() ICustomTypeDescriptor.GetClassName() ICustomTypeDescriptor.GetClassName() ICustomTypeDescriptor.GetClassName()

Restituisce il nome della classe per questa istanza di un componente.Returns the class name of this instance of a component.

(Inherited from DbConnectionStringBuilder)
ICustomTypeDescriptor.GetComponentName() ICustomTypeDescriptor.GetComponentName() ICustomTypeDescriptor.GetComponentName() ICustomTypeDescriptor.GetComponentName()

Restituisce il nome di questa istanza di un componente.Returns the name of this instance of a component.

(Inherited from DbConnectionStringBuilder)
ICustomTypeDescriptor.GetConverter() ICustomTypeDescriptor.GetConverter() ICustomTypeDescriptor.GetConverter() ICustomTypeDescriptor.GetConverter()

Restituisce il convertitore di tipi per questa istanza di un componente.Returns a type converter for this instance of a component.

(Inherited from DbConnectionStringBuilder)
ICustomTypeDescriptor.GetDefaultEvent() ICustomTypeDescriptor.GetDefaultEvent() ICustomTypeDescriptor.GetDefaultEvent() ICustomTypeDescriptor.GetDefaultEvent()

Restituisce l'evento predefinito per questa istanza di un componente.Returns the default event for this instance of a component.

(Inherited from DbConnectionStringBuilder)
ICustomTypeDescriptor.GetDefaultProperty() ICustomTypeDescriptor.GetDefaultProperty() ICustomTypeDescriptor.GetDefaultProperty() ICustomTypeDescriptor.GetDefaultProperty()

Restituisce la proprietà predefinita per questa istanza di un componente.Returns the default property for this instance of a component.

(Inherited from DbConnectionStringBuilder)
ICustomTypeDescriptor.GetEditor(Type) ICustomTypeDescriptor.GetEditor(Type) ICustomTypeDescriptor.GetEditor(Type) ICustomTypeDescriptor.GetEditor(Type)

Restituisce un editor del tipo specificato per questa istanza di un componente.Returns an editor of the specified type for this instance of a component.

(Inherited from DbConnectionStringBuilder)
ICustomTypeDescriptor.GetEvents() ICustomTypeDescriptor.GetEvents() ICustomTypeDescriptor.GetEvents() ICustomTypeDescriptor.GetEvents()

Restituisce gli eventi per questa istanza di un componente.Returns the events for this instance of a component.

(Inherited from DbConnectionStringBuilder)
ICustomTypeDescriptor.GetEvents(Attribute[]) ICustomTypeDescriptor.GetEvents(Attribute[]) ICustomTypeDescriptor.GetEvents(Attribute[]) ICustomTypeDescriptor.GetEvents(Attribute[])

Restituisce gli eventi per questa istanza di un componente utilizzando come filtro la matrice di attributi specificata.Returns the events for this instance of a component using the specified attribute array as a filter.

(Inherited from DbConnectionStringBuilder)
ICustomTypeDescriptor.GetProperties() ICustomTypeDescriptor.GetProperties() ICustomTypeDescriptor.GetProperties() ICustomTypeDescriptor.GetProperties()

Restituisce le proprietà per questa istanza di un componente.Returns the properties for this instance of a component.

(Inherited from DbConnectionStringBuilder)
ICustomTypeDescriptor.GetProperties(Attribute[]) ICustomTypeDescriptor.GetProperties(Attribute[]) ICustomTypeDescriptor.GetProperties(Attribute[]) ICustomTypeDescriptor.GetProperties(Attribute[])

Restituisce le proprietà per questa istanza di un componente utilizzando come filtro la matrice di attributi.Returns the properties for this instance of a component using the attribute array as a filter.

(Inherited from DbConnectionStringBuilder)
ICustomTypeDescriptor.GetPropertyOwner(PropertyDescriptor) ICustomTypeDescriptor.GetPropertyOwner(PropertyDescriptor) ICustomTypeDescriptor.GetPropertyOwner(PropertyDescriptor) ICustomTypeDescriptor.GetPropertyOwner(PropertyDescriptor)

Restituisce un oggetto contenente la proprietà descritta dal descrittore di proprietà specificato.Returns an object that contains the property described by the specified property descriptor.

(Inherited from DbConnectionStringBuilder)
IDictionary.Add(Object, Object) IDictionary.Add(Object, Object) IDictionary.Add(Object, Object) IDictionary.Add(Object, Object)

Aggiunge un elemento con la chiave e il valore forniti all'oggetto IDictionary.Adds an element with the provided key and value to the IDictionary object.

(Inherited from DbConnectionStringBuilder)
IDictionary.Contains(Object) IDictionary.Contains(Object) IDictionary.Contains(Object) IDictionary.Contains(Object)

Determina se l'oggetto IDictionary contiene un elemento con la chiave specificata.Determines whether the IDictionary object contains an element with the specified key.

(Inherited from DbConnectionStringBuilder)
IDictionary.GetEnumerator() IDictionary.GetEnumerator() IDictionary.GetEnumerator() IDictionary.GetEnumerator()

Restituisce un oggetto IDictionaryEnumerator per l'oggetto IDictionary.Returns an IDictionaryEnumerator object for the IDictionary object.

(Inherited from DbConnectionStringBuilder)
IDictionary.Remove(Object) IDictionary.Remove(Object) IDictionary.Remove(Object) IDictionary.Remove(Object)

Rimuove dall'oggetto IDictionary l'elemento con la chiave specificata.Removes the element with the specified key from the IDictionary object.

(Inherited from DbConnectionStringBuilder)
IEnumerable.GetEnumerator() IEnumerable.GetEnumerator() IEnumerable.GetEnumerator() IEnumerable.GetEnumerator()

Restituisce un enumeratore che consente di eseguire l'iterazione di una raccolta.Returns an enumerator that iterates through a collection.

(Inherited from DbConnectionStringBuilder)

Extension Methods

Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable)

Esegue il cast degli elementi di un oggetto IEnumerable nel tipo specificato.Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable)

Filtra gli elementi di un oggetto IEnumerable in base a un tipo specificato.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable) AsParallel(IEnumerable) AsParallel(IEnumerable) AsParallel(IEnumerable)

Consente la parallelizzazione di una query.Enables parallelization of a query.

AsQueryable(IEnumerable) AsQueryable(IEnumerable) AsQueryable(IEnumerable) AsQueryable(IEnumerable)

Converte un oggetto IEnumerable in un oggetto IQueryable.Converts an IEnumerable to an IQueryable.

Si applica a

Vedi anche