OleDbConnectionStringBuilder.Provider Vlastnost

Reference

Definice

Obor názvů:: System.Data.OleDb

Sestavení:: System.Data.OleDb.dll

Sestavení:: System.Data.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Získá nebo nastaví řetězec obsahující název zprostředkovatele dat přidruženého k internímu připojovacímu řetězci.

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

public string Provider { get; set; }

[System.ComponentModel.TypeConverter(typeof(System.Data.OleDb.OleDbConnectionStringBuilder+OleDbProviderConverter))]
public string Provider { get; set; }

member this.Provider : string with get, set

[<System.ComponentModel.TypeConverter(typeof(System.Data.OleDb.OleDbConnectionStringBuilder+OleDbProviderConverter))>]
member this.Provider : string with get, set

Public Property Provider As String

Hodnota vlastnosti

String

Hodnota Provider vlastnosti nebo String.Empty pokud nebyla zadána žádná.

Atributy: TypeConverterAttribute

Příklady

Následující příklad vytvoří více OleDbConnectionStringBuilder instancí a v každém případě předá konstruktoru jiný připojovací řetězec. Všimněte si, jak nastavení zprostředkovatele přidruženého k připojení změní sadu předdefinovaných párů klíč/hodnota v kolekci objektu.

Poznámka

Tento příklad obsahuje heslo, které ukazuje, jak OleDbConnectionStringBuilder funguje s připojovacími řetězci. Ve vašich aplikacích doporučujeme používat ověřování systému Windows. Pokud je nutné použít heslo, nevkládejte do své aplikace pevně zakódované heslo.

using System.Data.OleDb;

class Program
{
    static void Main()
    {
        try
        {
            // Build an empty instance, just to see
            // the contents of the keys.
            DumpBuilderContents("");

            // Create a SQL Server connection string.
            DumpBuilderContents("Provider=sqloledb;Data Source=(local);" +
                "Initial Catalog=AdventureWorks;" +
                "User Id=ab;Password=Password@1");

            // Create an Access connection string.
            DumpBuilderContents("Provider=Microsoft.Jet.OLEDB.4.0;" +
                @"Data Source=C:\Sample.mdb");

            // Create an Oracle connection string.
            DumpBuilderContents("Provider=msdaora;Data Source=SomeOracleDb;" +
                "User Id=userName;Password=Pass@word1;");

            // Create a Sybase connection string.
            DumpBuilderContents("Provider=ASAProv;Data source=myASA");

            Console.WriteLine("Press any key to finish.");
            Console.ReadLine();
        }
        catch (System.ArgumentException ex)
        {

            Console.WriteLine("Error: " + ex.Message);
        }
    }

    private static void DumpBuilderContents(string connectString)
    {
        OleDbConnectionStringBuilder builder =
            new OleDbConnectionStringBuilder(connectString);
        Console.WriteLine("=================");
        Console.WriteLine("Original connectString   = " + connectString);
        Console.WriteLine("builder.ConnectionString = " + builder.ConnectionString);
        foreach (string key in builder.Keys)
        {
            Console.WriteLine(key + "=" + builder[key].ToString());
        }
    }
}

Imports System.Data.OleDb    

Module Module1
  Sub Main()
    Try
      ' Build an empty instance, just to see
      ' the contents of the keys.
      DumpBuilderContents("")

      ' Create a SQL Server connection string.
      DumpBuilderContents("Provider=sqloledb;Data Source=(local);" & _
       "Initial Catalog=AdventureWorks;" & _
       "User Id=ab;Password=Password@1")

      ' Create an Access connection string.
      DumpBuilderContents("Provider=Microsoft.Jet.OLEDB.4.0;" & _
       "Data Source=C:\Sample.mdb")

      ' Create an Oracle connection string.
      DumpBuilderContents("Provider=msdaora;Data Source=SomeOracleDb;" & _
       "User Id=userName;Password=Pass@word1;")

      ' Create a Sybase connection string.
      DumpBuilderContents("Provider=ASAProv;Data source=myASA")

      Console.WriteLine("Press any key to finish.")
      Console.ReadLine()

    Catch ex As System.ArgumentException
      Console.WriteLine("Error: " & ex.Message)
    End Try
  End Sub

  Private Sub DumpBuilderContents(ByVal connectString As String)
    Dim builder As New OleDbConnectionStringBuilder(connectString)
    Console.WriteLine("=================")
    Console.WriteLine("Original connectString   = " & connectString)
    Console.WriteLine("builder.ConnectionString = " & builder.ConnectionString)
    For Each key As String In builder.Keys
      Console.WriteLine(key & "=" & builder.Item(key).ToString)
    Next
  End Sub
End Module

Poznámky

Pokud je hodnota předaná null při pokusu o nastavení vlastnosti, Provider vlastnost se resetuje. Pokud hodnota nebyla nastavena a vývojář se pokusí načíst vlastnost, návratová hodnota je String.Empty. Tato vlastnost odpovídá klíči "Provider" v připojovacím řetězci.

Nastavení hodnoty Provider vlastnosti, buď přímo (nastavením ConnectionString vlastnosti) nebo předáním připojovacího řetězce jako parametr konstruktoru, může ovlivnit sadu párů klíč/hodnota obsažených v OleDbConnectionStringBuilder instanci. Provider Nastavení vlastnosti na sqloledb, například přidá všechny standardní vlastnosti připojovacího řetězce SQL. Ukázku tohoto chování najdete v příkladu v tomto tématu.

U některých poskytovatelů přiřazení připojovacího řetězce v konstruktoru OleDbConnectionStringBuilder způsobí, že pořadí zadaných párů klíč/hodnota se přeuspořádá.

Platí pro