OleDbConnection.DataSource Property

Reference

Definition

Namespace:: System.Data.OleDb

Assembly:: System.Data.OleDb.dll

Assembly:: System.Data.dll

Package:: System.Data.OleDb v10.0.0-preview.1.25080.5

Source:: OleDbConnection.cs

Source:: OleDbConnection.cs

Source:: OleDbConnection.cs

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Gets the server name or file name of the data source.

public:
 virtual property System::String ^ DataSource { System::String ^ get(); };

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

[System.ComponentModel.Browsable(true)]
public override string DataSource { get; }

[System.Data.DataSysDescription("OleDbConnection_DataSource")]
public string DataSource { get; }

[<System.ComponentModel.Browsable(true)>]
member this.DataSource : string

[<System.Data.DataSysDescription("OleDbConnection_DataSource")>]
member this.DataSource : string

Public Overrides ReadOnly Property DataSource As String

Public ReadOnly Property DataSource As String

Property Value

String

The server name or file name of the data source. The default value is an empty string.

Attributes: BrowsableAttribute DataSysDescriptionAttribute

Examples

The following example creates an OleDbConnection and displays some of its read-only properties.

static void OpenConnection(string connectionString)
{
    using (OleDbConnection connection = new OleDbConnection(connectionString))
    {
        try
        {
            connection.Open();
            Console.WriteLine("ServerVersion: {0} \nDataSource: {1}",
                connection.ServerVersion, connection.DataSource);
        }
        catch (Exception ex)
        {
            Console.WriteLine(ex.Message);
        }
        // The connection is automatically closed when the
        // code exits the using block.
    }
}

Public Sub OpenConnection(ByVal connectionString As String)

    Using connection As New OleDbConnection(connectionString)
        Try
            connection.Open()
            Console.WriteLine("Server Version: {0} DataSource: {1}", _
                connection.ServerVersion, connection.DataSource)
        Catch ex As Exception
            Console.WriteLine(ex.Message)
        End Try
        ' The connection is automatically closed when the
        ' code exits the Using block.
    End Using
End Sub

Remarks

If the connection to the database is closed, the DataSource property returns whatever is contained in ConnectionString for the data source keyword. If the connection is open and the ConnectionString data source keyword's value starts with "|datadirectory|", the property returns whatever is contained in ConnectionString for the data source keyword only. If the connection to the database is open, the property returns what the native provider returns for the DBPROP_INIT_DATASOURCE, and if that is empty, the native provider's DBPROP_DATASOURCENAME is returned.

Applies to

Product	Versions
.NET	8 (package-provided), 9 (package-provided), 10 (package-provided)
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	2.0 (package-provided)

Share via