OleDbConnectionStringBuilder.Remove(String) Metoda
Definice
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í.
Odebere z instance položku se zadaným OleDbConnectionStringBuilder klíčem.
public:
override bool Remove(System::String ^ keyword);
public override bool Remove (string keyword);
override this.Remove : string -> bool
Public Overrides Function Remove (keyword As String) As Boolean
Parametry
- keyword
- String
Klíč dvojice klíč/hodnota, který se má odebrat z připojovací řetězec v tomto OleDbConnectionStringBuildersouboru .
Návraty
true
pokud klíč existoval v rámci připojovací řetězec a byl odebrán, false
pokud klíč neexistoval.
Výjimky
keyword
is null (Nothing
v jazyce Visual Basic).
Příklady
Následující příklad vytvoří OleDbConnectionStringBuilder a demonstruje chování Remove metody .
using System.Data.OleDb;
class Program
{
static void Main()
{
OleDbConnectionStringBuilder builder =
new OleDbConnectionStringBuilder();
builder.ConnectionString =
"Provider=Microsoft.Jet.OLEDB.4.0;Data Source=C:\\Sample.mdb;" +
"Jet OLEDB:System Database=C:\\system.mdw;";
Console.WriteLine(builder.ConnectionString);
// Try to remove an existing item.
TryRemove(builder, "Provider");
// Try to remove a nonexistent item.
TryRemove(builder, "User ID");
// try to remove an existing item,
// demonstrating that the search isn't
// case sensitive.
TryRemove(builder, "DATA SOURCE");
Console.WriteLine("Press Enter to continue.");
Console.ReadLine();
}
static void TryRemove(OleDbConnectionStringBuilder builder,
string itemToRemove)
{
if (builder.Remove(itemToRemove))
{
Console.WriteLine("Removed '{0}'", itemToRemove);
}
else
{
Console.WriteLine("Unable to remove '{0}'", itemToRemove);
}
Console.WriteLine(builder.ConnectionString);
}
}
Imports System.Data.OleDb
Module Module1
Sub Main()
Dim builder As New OleDbConnectionStringBuilder
builder.ConnectionString = _
"Provider=Microsoft.Jet.OLEDB.4.0;Data Source=C:\Sample.mdb;" & _
"Jet OLEDB:System Database=C:\system.mdw;"
Console.WriteLine(builder.ConnectionString)
' Try to remove an existing item.
TryRemove(builder, "Provider")
' Try to remove a nonexistent item.
TryRemove(builder, "User ID")
' Try to remove an existing item,
' demonstrating that the search is not
' case sensitive.
TryRemove(builder, "DATA SOURCE")
Console.WriteLine("Press Enter to continue.")
Console.ReadLine()
End Sub
Sub TryRemove(ByVal builder As OleDbConnectionStringBuilder, _
ByVal itemToRemove As String)
If builder.Remove(itemToRemove) Then
Console.WriteLine("Removed '{0}'", itemToRemove)
Else
Console.WriteLine("Unable to remove '{0}'", itemToRemove)
End If
Console.WriteLine(builder.ConnectionString)
End Sub
End Module
Poznámky
Vzhledem k Remove tomu, že metoda vrací hodnotu, která označuje její úspěch, není nutné hledat existenci klíče před pokusem o odebrání páru klíč-hodnota z OleDbConnectionStringBuilder instance.