SqlConnectionStringBuilder.DataSource Eigenschaft

Referenz

Definition

Namespace:: System.Data.SqlClient

Assembly:: System.Data.SqlClient.dll

Assembly:: System.Data.dll

Paket:: System.Data.SqlClient v4.8.6

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ruft den Namen oder die Netzwerkadresse der Instanz von SQL Server ab, mit der eine Verbindung hergestellt werden soll, oder legt einen Namen bzw. eine Adresse fest.

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

public string DataSource { get; set; }

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

member this.DataSource : string with get, set

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

Public Property DataSource As String

Eigenschaftswert

String

Der Wert der DataSource-Eigenschaft bzw. String.Empty, wenn kein Wert angegeben wurde.

Attribute: TypeConverterAttribute

Ausnahmen

ArgumentNullException

Verwenden Sie Value, um den Wert auf NULL festzulegen.

Beispiele

Im folgenden Beispiel wird gezeigt, dass die SqlConnectionStringBuilder-Klasse Synonyme für den Verbindungszeichenfolgenschlüssel "Data Source" in einen bekannten Schlüssel konvertiert:

using System.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();
    }
}

Imports System.Data.SqlClient

Module Module1

    Sub Main()
        Dim builder As _
         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()
    End Sub
End Module

Hinweise

Diese Eigenschaft entspricht den Schlüsseln "Data Source", "server", "address", "addr" und "network address" in der Verbindungszeichenfolge. Unabhängig davon, welcher dieser Werte innerhalb des angegebenen Verbindungszeichenfolge angegeben wurde, verwendet der von SqlConnectionStringBuilder erstellte Verbindungszeichenfolge den bekannten Schlüssel "Datenquelle".

Gilt für: