OleDbConnectionStringBuilder.Clear Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Löscht den Inhalt der OleDbConnectionStringBuilder-Instanz.
public:
override void Clear();public override void Clear ();override this.Clear : unit -> unitPublic Overrides Sub Clear ()Beispiele
Im folgenden Beispiel wird die Auswirkung des Aufrufs der Clear -Methode veranschaulicht. In diesem Beispiel wird der OleDbConnectionStringBuilder mit einigen Schlüssel-Wert-Paaren aufgefüllt. Anschließend wird die Clear-Methode aufgerufen, und die Ergebnisse werden angezeigt.
Hinweis
Das Beispiel umfasst ein Kennwort zur Veranschaulichung der Funktion von OleDbConnectionStringBuilder mit Verbindungszeichenfolgen. In den Anwendungen wird die Verwendung der Windows-Authentifizierung empfohlen. Wenn Sie ein Kennwort verwenden müssen, schließen Sie kein hartcodiertes Kennwort in die Anwendung ein.
using System.Data.OleDb;
class Program
{
static void Main()
{
OleDbConnectionStringBuilder builder =
new OleDbConnectionStringBuilder();
builder.ConnectionString = @"Data Source=c:\Sample.mdb";
// Call the Add method to explicitly add key/value
// pairs to the internal collection.
builder.Add("Provider", "Microsoft.Jet.Oledb.4.0");
builder.Add("Jet OLEDB:Database Password", "MyPassword!");
builder.Add("Jet OLEDB:System Database", @"C:\Workgroup.mdb");
// set up row-level locking.
builder.Add("Jet OLEDB:Database Locking Mode", 1);
// Dump the contents of the "filled-in"
// OleDbConnectionStringBuilder
// to the console window.
DumpBuilderContents(builder);
// Clear current values and reset known keys to their
// default values.
builder.Clear();
// Dump the contents of the newly emptied
// OleDbConnectionStringBuilder
// to the console window.
DumpBuilderContents(builder);
Console.WriteLine("Press Enter to continue.");
Console.ReadLine();
}
private static void DumpBuilderContents(OleDbConnectionStringBuilder builder)
{
Console.WriteLine("=================");
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()
Dim builder As New OleDbConnectionStringBuilder()
builder.ConnectionString = "Data Source=C:\Sample.mdb"
' Call the Add method to explicitly add key/value
' pairs to the internal collection.
builder.Add("Provider", "Microsoft.Jet.Oledb.4.0")
builder.Add("Jet OLEDB:Database Password", "MyPassword!")
builder.Add("Jet OLEDB:System Database", "C:\Workgroup.mdb")
' Set up row-level locking.
builder.Add("Jet OLEDB:Database Locking Mode", 1)
' Dump the contents of the "filled-in" OleDbConnectionStringBuilder
' to the console window.
DumpBuilderContents(builder)
' Clear current values and reset known keywords to their
' default values.
builder.Clear()
' Dump the contents of the newly emptied
' OleDbConnectionStringBuilder
' to the console window.
DumpBuilderContents(builder)
Console.WriteLine("Press Enter to continue.")
Console.ReadLine()
End Sub
Private Sub DumpBuilderContents(ByVal builder As OleDbConnectionStringBuilder)
Console.WriteLine("=================")
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
Hinweise
Die Clear -Methode entfernt alle Schlüssel-Wert-Paare aus dem OleDbConnectionStringBuilderund setzt alle entsprechenden Eigenschaften auf ihre Standardwerte zurück. Dies schließt das Festlegen der Count-Eigenschaft auf 0 und das Festlegen der ConnectionString-Eigenschaft auf eine leere Zeichenfolge ein.
