OracleConnectionStringBuilder.DataSource Property


The .NET API Reference documentation has a new home. Visit the .NET API Browser on to see the new experience.

Gets or sets the name of the Oracle data source to connect to.

Namespace:   System.Data.OracleClient
Assembly:  System.Data.OracleClient (in System.Data.OracleClient.dll)

Public Property DataSource As String

Property Value

Type: System.String

The value of the DataSource property, or Empty if none has been supplied.

This property corresponds to the "Data Source" and "Server" keys within the connection string. Regardless of which of these values has been supplied within the supplied connection string, the connection string created by the OracleConnectionStringBuilder will use the well-known "Data Source" key. If the value passed in is null when you try to set the property, the DataSource property is reset. If the value has not been set and the developer tries to retrieve the property, the return value is Empty.

The following example demonstrates that the OracleConnectionStringBuilder class converts synonyms for the "Data Source" connection string key into the well-known key.

' You may need to set a reference to the System.Data.OracleClient
' assembly before running this example.
Imports System.Data.OracleClient

Module Module1

  Sub Main()
    Dim builder As _
     New OracleConnectionStringBuilder( _
     "Server=OracleDemo;Integrated Security=True")

    ' Display the connection string, which should now 
    ' contains the "Data Source" key, as opposed to the 
    ' supplied "Server".

    ' Retrieve the DataSource property.
    Console.WriteLine("DataSource = " & builder.DataSource)

    Console.WriteLine("Press any key to continue.")
  End Sub

End Module

.NET Framework
Available since 2.0
Return to top