OdbcConnectionStringBuilder Classe

Definição

public ref class OdbcConnectionStringBuilder sealed : System::Data::Common::DbConnectionStringBuilder

[System.ComponentModel.TypeConverter(typeof(System.Data.Odbc.OdbcConnectionStringBuilder+OdbcConnectionStringBuilderConverter))]
public sealed class OdbcConnectionStringBuilder : System.Data.Common.DbConnectionStringBuilder

[<System.ComponentModel.TypeConverter(typeof(System.Data.Odbc.OdbcConnectionStringBuilder+OdbcConnectionStringBuilderConverter))>]
type OdbcConnectionStringBuilder = class
    inherit DbConnectionStringBuilder

Public NotInheritable Class OdbcConnectionStringBuilder
Inherits DbConnectionStringBuilder

Herança

Object

DbConnectionStringBuilder

OdbcConnectionStringBuilder

Atributos

TypeConverterAttribute

Exemplos

A aplicação de consola seguinte constrói strings de ligação para várias bases de dados ODBC. Primeiro, o exemplo cria uma cadeia de ligação para uma base de dados do Microsoft Access. Depois, cria uma cadeia de ligação para uma base de dados IBM DB2. O exemplo também analisa uma cadeia de ligação existente e demonstra várias formas de manipular o conteúdo da cadeia de ligação.

using System.Data.Odbc;

class Program
{
    static void Main()
    {
        OdbcConnectionStringBuilder builder = new()
            {
                Driver = "Microsoft Access Driver (*.mdb)"
            };

        // Call the Add method to explicitly add key/value
        // pairs to the internal collection.
        builder.Add("Dbq", "C:\\info.mdb");

        Console.WriteLine(builder.ConnectionString);
        Console.WriteLine();

        // Clear current values and reset known keys to their
        // default values.
        builder.Clear();

        // Pass the OdbcConnectionStringBuilder an existing
        // connection string, and you can retrieve and
        // modify any of the elements.
        builder.ConnectionString =
            "driver={IBM DB2 ODBC DRIVER};Database=SampleDB;" +
            "hostname=SampleServerName;port=SamplePortNum;" +
            "protocol=TCPIP";

        Console.WriteLine($"protocol = {builder["protocol"].ToString()}");
        Console.WriteLine();

        // Call the Remove method to remove items from
        // the collection of key/value pairs.
        builder.Remove("port");

        // Note that calling Remove on a nonexistent item does not
        // throw an exception.
        builder.Remove("BadItem");
        Console.WriteLine(builder.ConnectionString);
        Console.WriteLine();

        // Setting the indexer adds the associated value, if
        // necessary.
        builder["NewKey"] = "newValue";
        Console.WriteLine(builder.ConnectionString);
    }
}

Imports System.Data.Odbc

Module Module1
    Sub Main()
        Dim builder As New OdbcConnectionStringBuilder With {
            .Driver = "Microsoft Access Driver (*.mdb)"
        }

        ' Call the Add method to explicitly add key/value
        ' pairs to the internal collection.
        builder.Add("Dbq", "C:\info.mdb")

        Console.WriteLine(builder.ConnectionString)
        Console.WriteLine()

        ' Clear current values and reset known keys to their
        ' default values.
        builder.Clear()

        ' Pass the OdbcConnectionStringBuilder an existing
        ' connection string, and you can retrieve and
        ' modify any of the elements.
        builder.ConnectionString =
            "driver={IBM DB2 ODBC DRIVER};Database=SampleDB;" &
            "hostname=SampleServerName;port=SamplePortNum;" &
            "protocol=TCPIP"

        Console.WriteLine("protocol = " & builder("protocol").ToString())
        Console.WriteLine()

        ' Call the Remove method to remove items from
        ' the collection of key/value pairs.
        builder.Remove("port")

        ' Note that calling Remove on a nonexistent item does not
        ' throw an exception.
        builder.Remove("BadItem")
        Console.WriteLine(builder.ConnectionString)
        Console.WriteLine()

        ' The Item property is the default for the class,
        ' and setting the Item property adds the value, if
        ' necessary.
        builder("NewKey") = "newValue"
        Console.WriteLine(builder.ConnectionString)

        Console.WriteLine("Press Enter to finish.")
        Console.ReadLine()
    End Sub
End Module

Observações

Os construtores de cadeia de ligação permitem aos programadores criar programaticamente cadeias de ligação sintaticamente corretas, e analisar e reconstruir cadeias de ligação existentes, usando propriedades e métodos da classe. O cadeia de ligação builder fornece propriedades fortemente tipadas correspondentes aos pares chave/valor conhecidos permitidos pelas ligações ODBC, e os programadores podem adicionar pares de chave/valor arbitrários para quaisquer outros valores de cadeia de ligação.

Os programadores que precisam de criar strings de ligação como parte de aplicações podem usar a OdbcConnectionStringBuilder classe para construir e modificar strings de ligação. A classe também facilita a gestão de cadeias de ligação armazenadas num ficheiro de configuração de aplicação. OdbcConnectionStringBuilder realiza verificações apenas para o conjunto limitado de pares chave/valor conhecidos. Portanto, esta classe pode ser usada para criar cadeias de ligação inválidas. A tabela seguinte lista as chaves específicas conhecidas juntamente com as respetivas propriedades dentro da OdbcConnectionStringBuilder classe e os seus valores padrão. Para além destes valores específicos, os programadores podem adicionar quaisquer pares chave/valor à coleção contida na OdbcConnectionStringBuilder instância.

Se qualquer valor (diferente do Driver) dentro do cadeia de ligação contiver um ponto e vírgula (;), o OdbcConnectionStringBuilder rodeia o valor com aspas no cadeia de ligação. Para evitar este problema com o Driver valor que frequentemente contém um ponto e vírgula, a OdbcConnectionStringBuilder classe rodeia sempre esse valor com colchetes. A especificação ODBC indica que valores de driver que contêm ponto e vírgula devem estar rodeados por chaves, e esta classe trata disso por si.

A Item[] propriedade trata de tentativas de inserir código malicioso. Por exemplo, o código seguinte, usando a propriedade padrão Item[] (o indexador, em C#), escapa corretamente do par chave/valor aninhado.

Dim builder As _
 New System.Data.Odbc.OdbcConnectionStringBuilder
' Take advantage of the Driver property.
builder.Driver = "SQL Server"
builder("Server") = "MyServer;NewValue=Bad"
Console.WriteLine(builder.ConnectionString)

System.Data.Odbc.OdbcConnectionStringBuilder builder =
  new System.Data.Odbc.OdbcConnectionStringBuilder();
// Take advantage of the Driver property.
builder.Driver = "SQL Server";
builder["Server"] = "MyServer;NewValue=Bad";
Console.WriteLine(builder.ConnectionString);

O resultado é a seguinte cadeia de ligação que trata o valor inválido de forma segura:

Driver={SQL Server};Server="MyServer;NewValue=Bad"

Ver também

• Construtores de cadeias de conexão
• Cadeias de conexão no ADO.NET