Edit

Share via

OracleConnectionStringBuilder.DataSource Property

  • Reference

Definition

Namespace:
System.Data.OracleClient
Assembly:
System.Data.OracleClient.dll

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

public:
 property System::String ^ DataSource { System::String ^ get(); void set(System::String ^ value); };
public string DataSource { get; set; }
member this.DataSource : string with get, set
Public Property DataSource As String

Property Value

String

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

Examples

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 you can run this sample.
using System.Data.OracleClient;

class Program
{
    static void Main()
    {
        OracleConnectionStringBuilder builder =
            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".
        Console.WriteLine(builder.ConnectionString);

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

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

' 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".
    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

Remarks

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.

Applies to

See also