SqlConnectionStringBuilder.DataSource Proprietà

public:
 property System::String ^ DataSource { System::String ^ get(); void set(System::String ^ value); };

[System.ComponentModel.TypeConverter(typeof(Microsoft.Data.SqlClient.SqlConnectionStringBuilder+SqlDataSourceConverter))]
public string DataSource { get; set; }

public string DataSource { get; set; }

[<System.ComponentModel.TypeConverter(typeof(Microsoft.Data.SqlClient.SqlConnectionStringBuilder+SqlDataSourceConverter))>]
member this.DataSource : string with get, set

member this.DataSource : string with get, set

Public Property DataSource As String

Valore della proprietà

Valore della proprietà DataSource o String.Empty se non è stato fornito alcun valore.

Attributi

TypeConverterAttribute

Eccezioni

Esempio

Nel seguente esempio viene dimostrato che la classe SqlConnectionStringBuilder converte i sinonimi per la chiave della stringa di connessione "Data Source" in una chiave nota.

using Microsoft.Data.SqlClient;

class Program
{
    static void Main()
    {
        SqlConnectionStringBuilder builder = new SqlConnectionStringBuilder(
            "Network Address=(local);Integrated Security=SSPI;" +
            "Initial Catalog=AdventureWorks");

        // Display the connection string, which should now 
        // contain the "Data Source" key, as opposed to the 
        // supplied "Network Address".
        Console.WriteLine(builder.ConnectionString);

        // Retrieve the DataSource property.
        Console.WriteLine("DataSource = " + builder.DataSource);

        Console.WriteLine("Press any key to continue.");
        Console.ReadLine();
    }
}

Commenti

Questa proprietà corrisponde alle chiavi "Data Source", "server", "address", "addr" e "network address" all'interno della stringa di connessione. Indipendentemente da quale di questi valori è stato fornito all'interno della stringa di connessione fornita, la stringa di connessione creata da SqlConnectionStringBuilder userà la chiave "Origine dati" nota.

Il numero di porta può essere specificato dopo il nome del server: server=tcp:servername, portnumber.

Quando si specifica un'istanza locale, usare sempre (locale). Per forzare un protocollo, aggiungere uno dei prefissi seguenti:np:(local), tcp:(local), lpc:(local)

È anche possibile connettersi a un database LocalDB come indicato di seguito: server=(localdb)\\myInstance. Per altre informazioni su LocalDB, vedere Supporto sqlClient per LocalDB. L'origine dati deve utilizzare il formato TCP o named pipe. Il formato TCP è il seguente:

• tcp:<host name>\<instance name>
• tcp:<host name,TCP></IP port number>

Il formato TCP deve iniziare con il prefisso "tcp:" ed è seguito dall'istanza del database, come specificato da un nome host e da un nome di istanza. Questo formato non è applicabile quando ci si connette a Azure SQL Database. TCP viene selezionato automaticamente per le connessioni a Azure SQL Database quando non viene specificato alcun protocollo.

Il nome host DEVE essere specificato in uno dei modi seguenti:

• NetBIOSName
• Indirizzo IPv4
• Indirizzo IPv6

Il nome dell'istanza viene usato per risolvere un determinato numero di porta TCP/IP in cui è ospitata un'istanza del database. In alternativa, è consentito specificare direttamente un numero di porta TCP/IP. Se il nome dell'istanza e il numero di porta non sono presenti, viene utilizzata l'istanza del database predefinita.

Il formato Named Pipes è il seguente:

• np:\\<host name>\pipe\<pipe name>

Il formato Named Pipes DEVE iniziare con il prefisso "np:" ed è seguito da un nome named pipe.

Il nome host DEVE essere specificato in uno dei modi seguenti:

• NetBIOSName
• Indirizzo IPv4
• Indirizzo IPv6

Il nome della pipe viene usato per identificare l'istanza del database a cui si connetterà l'applicazione .NET.

Se viene specificato il valore della chiave di rete , i prefissi "tcp:" e "np:" non devono essere specificati. Nota: È possibile forzare l'uso di TCP anziché di memoria condivisa, anteponendo tcp: al nome del server nella stringa di connessione o tramite localhost.

Si applica a