SqlDataAdapter Konstruktory
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í.
Inicializuje novou instanci SqlDataAdapter třídy.
Přetížení
| Name | Description |
|---|---|
| SqlDataAdapter() |
Inicializuje novou instanci SqlDataAdapter třídy. |
| SqlDataAdapter(SqlCommand) |
Inicializuje novou instanci SqlDataAdapter třídy se zadaným SqlCommand jako SelectCommand vlastnost. |
| SqlDataAdapter(String, SqlConnection) |
Inicializuje novou instanci SqlDataAdapter třídy pomocí SelectCommand a objektu SqlConnection . |
| SqlDataAdapter(String, String) |
Inicializuje novou instanci SqlDataAdapter třídy pomocí SelectCommand připojovacího řetězce a připojovacího řetězce. |
SqlDataAdapter()
Inicializuje novou instanci SqlDataAdapter třídy.
public:
SqlDataAdapter();
public SqlDataAdapter();
Public Sub New ()
Příklady
Následující příklad vytvoří SqlDataAdapter a nastaví některé jeho vlastnosti.
public static SqlDataAdapter CreateSqlDataAdapter(SqlConnection connection)
{
SqlDataAdapter adapter = new SqlDataAdapter();
adapter.MissingSchemaAction = MissingSchemaAction.AddWithKey;
// Create the commands.
adapter.SelectCommand = new SqlCommand(
"SELECT CustomerID, CompanyName FROM CUSTOMERS", connection);
adapter.InsertCommand = new SqlCommand(
"INSERT INTO Customers (CustomerID, CompanyName) " +
"VALUES (@CustomerID, @CompanyName)", connection);
adapter.UpdateCommand = new SqlCommand(
"UPDATE Customers SET CustomerID = @CustomerID, CompanyName = @CompanyName " +
"WHERE CustomerID = @oldCustomerID", connection);
adapter.DeleteCommand = new SqlCommand(
"DELETE FROM Customers WHERE CustomerID = @CustomerID", connection);
// Create the parameters.
adapter.InsertCommand.Parameters.Add("@CustomerID",
SqlDbType.Char, 5, "CustomerID");
adapter.InsertCommand.Parameters.Add("@CompanyName",
SqlDbType.VarChar, 40, "CompanyName");
adapter.UpdateCommand.Parameters.Add("@CustomerID",
SqlDbType.Char, 5, "CustomerID");
adapter.UpdateCommand.Parameters.Add("@CompanyName",
SqlDbType.VarChar, 40, "CompanyName");
adapter.UpdateCommand.Parameters.Add("@oldCustomerID",
SqlDbType.Char, 5, "CustomerID").SourceVersion =
DataRowVersion.Original;
adapter.DeleteCommand.Parameters.Add("@CustomerID",
SqlDbType.Char, 5, "CustomerID").SourceVersion =
DataRowVersion.Original;
return adapter;
}
Public Function CreateSqlDataAdapter( _
ByVal connection As SqlConnection) As SqlDataAdapter
Dim adapter As New SqlDataAdapter()
adapter.MissingSchemaAction = MissingSchemaAction.AddWithKey
' Create the commands.
adapter.SelectCommand = New SqlCommand( _
"SELECT CustomerID, CompanyName FROM CUSTOMERS", connection)
adapter.InsertCommand = New SqlCommand( _
"INSERT INTO Customers (CustomerID, CompanyName) " & _
"VALUES (@CustomerID, @CompanyName)", connection)
adapter.UpdateCommand = New SqlCommand( _
"UPDATE Customers SET CustomerID = @CustomerID, CompanyName = " & _
"@CompanyName WHERE CustomerID = @oldCustomerID", connection)
adapter.DeleteCommand = New SqlCommand( _
"DELETE FROM Customers WHERE CustomerID = @CustomerID", connection)
' Create the parameters.
adapter.InsertCommand.Parameters.Add("@CustomerID", _
SqlDbType.Char, 5, "CustomerID")
adapter.InsertCommand.Parameters.Add("@CompanyName", _
SqlDbType.VarChar, 40, "CompanyName")
adapter.UpdateCommand.Parameters.Add("@CustomerID", _
SqlDbType.Char, 5, "CustomerID")
adapter.UpdateCommand.Parameters.Add("@CompanyName", _
SqlDbType.VarChar, 40, "CompanyName")
adapter.UpdateCommand.Parameters.Add("@oldCustomerID", _
SqlDbType.Char, 5, "CustomerID").SourceVersion = _
DataRowVersion.Original
adapter.DeleteCommand.Parameters.Add("@CustomerID", _
SqlDbType.Char, 5, "CustomerID").SourceVersion = _
DataRowVersion.Original
Return adapter
End Function
Poznámky
Při vytvoření instance jsou SqlDataAdapter následující vlastnosti pro čtení a zápis nastaveny na následující počáteční hodnoty.
| Vlastnosti | Počáteční hodnota |
|---|---|
| MissingMappingAction | MissingMappingAction.Passthrough |
| MissingSchemaAction | MissingSchemaAction.Add |
Hodnotu kterékoli z těchto vlastností můžete změnit prostřednictvím samostatného volání vlastnosti.
Viz také
- Manipulace s daty (ADO.NET)
- Použití zprostředkovatele dat rozhraní .NET Framework pro SQL Server
- Přehled ADO.NET
Platí pro
SqlDataAdapter(SqlCommand)
Inicializuje novou instanci SqlDataAdapter třídy se zadaným SqlCommand jako SelectCommand vlastnost.
public:
SqlDataAdapter(System::Data::SqlClient::SqlCommand ^ selectCommand);
public SqlDataAdapter(System.Data.SqlClient.SqlCommand selectCommand);
new System.Data.SqlClient.SqlDataAdapter : System.Data.SqlClient.SqlCommand -> System.Data.SqlClient.SqlDataAdapter
Public Sub New (selectCommand As SqlCommand)
Parametry
- selectCommand
- SqlCommand
Jedná SqlCommand se o příkaz Transact-SQL SELECT nebo uloženou proceduru a je nastaven jako SelectCommand vlastnost SqlDataAdapter.
Příklady
Následující příklad vytvoří SqlDataAdapter a nastaví některé jeho vlastnosti.
public static SqlDataAdapter CreateSqlDataAdapter(SqlCommand selectCommand,
SqlConnection connection)
{
SqlDataAdapter adapter = new SqlDataAdapter(selectCommand);
adapter.MissingSchemaAction = MissingSchemaAction.AddWithKey;
// Create the other commands.
adapter.InsertCommand = new SqlCommand(
"INSERT INTO Customers (CustomerID, CompanyName) " +
"VALUES (@CustomerID, @CompanyName)", connection);
adapter.UpdateCommand = new SqlCommand(
"UPDATE Customers SET CustomerID = @CustomerID, CompanyName = @CompanyName " +
"WHERE CustomerID = @oldCustomerID", connection);
adapter.DeleteCommand = new SqlCommand(
"DELETE FROM Customers WHERE CustomerID = @CustomerID", connection);
// Create the parameters.
adapter.InsertCommand.Parameters.Add("@CustomerID",
SqlDbType.Char, 5, "CustomerID");
adapter.InsertCommand.Parameters.Add("@CompanyName",
SqlDbType.VarChar, 40, "CompanyName");
adapter.UpdateCommand.Parameters.Add("@CustomerID",
SqlDbType.Char, 5, "CustomerID");
adapter.UpdateCommand.Parameters.Add("@CompanyName",
SqlDbType.VarChar, 40, "CompanyName");
adapter.UpdateCommand.Parameters.Add("@oldCustomerID",
SqlDbType.Char, 5, "CustomerID").SourceVersion = DataRowVersion.Original;
adapter.DeleteCommand.Parameters.Add("@CustomerID",
SqlDbType.Char, 5, "CustomerID").SourceVersion = DataRowVersion.Original;
return adapter;
}
Public Function CreateSqlDataAdapter(ByVal selectCommand As SqlCommand, _
ByVal connection As SqlConnection) As SqlDataAdapter
Dim adapter As New SqlDataAdapter(selectCommand)
adapter.MissingSchemaAction = MissingSchemaAction.AddWithKey
' Create the commands.
adapter.InsertCommand = New SqlCommand( _
"INSERT INTO Customers (CustomerID, CompanyName) " & _
"VALUES (@CustomerID, @CompanyName)", connection)
adapter.UpdateCommand = New SqlCommand( _
"UPDATE Customers SET CustomerID = @CustomerID, CompanyName = @CompanyName " & _
"WHERE CustomerID = @oldCustomerID", connection)
adapter.DeleteCommand = New SqlCommand( _
"DELETE FROM Customers WHERE CustomerID = @CustomerID", connection)
' Create the parameters.
adapter.InsertCommand.Parameters.Add("@CustomerID", _
SqlDbType.Char, 5, "CustomerID")
adapter.InsertCommand.Parameters.Add("@CompanyName", _
SqlDbType.VarChar, 40, "CompanyName")
adapter.UpdateCommand.Parameters.Add("@CustomerID", _
SqlDbType.Char, 5, "CustomerID")
adapter.UpdateCommand.Parameters.Add("@CompanyName", _
SqlDbType.VarChar, 40, "CompanyName")
adapter.UpdateCommand.Parameters.Add("@oldCustomerID", _
SqlDbType.Char, 5, "CustomerID").SourceVersion = DataRowVersion.Original
adapter.DeleteCommand.Parameters.Add("@CustomerID", _
SqlDbType.Char, 5, "CustomerID").SourceVersion = DataRowVersion.Original
Return adapter
End Function
Poznámky
Tato implementace konstruktoru SqlDataAdapterSelectCommand nastaví vlastnost na hodnotu zadanou v parametru selectCommand .
Při vytvoření instance jsou SqlDataAdapter následující vlastnosti pro čtení a zápis nastaveny na následující počáteční hodnoty.
| Vlastnosti | Počáteční hodnota |
|---|---|
| MissingMappingAction | MissingMappingAction.Passthrough |
| MissingSchemaAction | MissingSchemaAction.Add |
Hodnotu kterékoli z těchto vlastností můžete změnit prostřednictvím samostatného volání vlastnosti.
Při SelectCommand přiřazení dříve vytvořené SqlCommandSqlCommand vlastnosti příkazu (nebo jakékoli jiné vlastnosti příkazu) se nenaklonuje. Udržuje SelectCommand odkaz na dříve vytvořený SqlCommand objekt.
Viz také
- Manipulace s daty (ADO.NET)
- Použití zprostředkovatele dat rozhraní .NET Framework pro SQL Server
- Přehled ADO.NET
Platí pro
SqlDataAdapter(String, SqlConnection)
Inicializuje novou instanci SqlDataAdapter třídy pomocí SelectCommand a objektu SqlConnection .
public:
SqlDataAdapter(System::String ^ selectCommandText, System::Data::SqlClient::SqlConnection ^ selectConnection);
public SqlDataAdapter(string selectCommandText, System.Data.SqlClient.SqlConnection selectConnection);
new System.Data.SqlClient.SqlDataAdapter : string * System.Data.SqlClient.SqlConnection -> System.Data.SqlClient.SqlDataAdapter
Public Sub New (selectCommandText As String, selectConnection As SqlConnection)
Parametry
- selectCommandText
- String
Jedná String se o příkaz Transact-SQL SELECT nebo uloženou proceduru SelectCommand , která má být použita vlastností SqlDataAdapter.
- selectConnection
- SqlConnection
A SqlConnection , který představuje připojení. Pokud se připojovací řetězec nepoužívá Integrated Security = true, můžete ho použít SqlCredential k bezpečnějšímu předání ID uživatele a hesla než zadáním ID uživatele a hesla jako textu v připojovacím řetězci.
Příklady
Následující příklad vytvoří SqlDataAdapter a nastaví některé jeho vlastnosti.
public static SqlDataAdapter CreateSqlDataAdapter(string commandText,
SqlConnection connection)
{
SqlDataAdapter adapter = new SqlDataAdapter(commandText, connection);
adapter.MissingSchemaAction = MissingSchemaAction.AddWithKey;
// Create the other commands.
adapter.InsertCommand = new SqlCommand(
"INSERT INTO Customers (CustomerID, CompanyName) " +
"VALUES (@CustomerID, @CompanyName)");
adapter.UpdateCommand = new SqlCommand(
"UPDATE Customers SET CustomerID = @CustomerID, CompanyName = @CompanyName " +
"WHERE CustomerID = @oldCustomerID");
adapter.DeleteCommand = new SqlCommand(
"DELETE FROM Customers WHERE CustomerID = @CustomerID");
// Create the parameters.
adapter.InsertCommand.Parameters.Add("@CustomerID",
SqlDbType.Char, 5, "CustomerID");
adapter.InsertCommand.Parameters.Add("@CompanyName",
SqlDbType.VarChar, 40, "CompanyName");
adapter.UpdateCommand.Parameters.Add("@CustomerID",
SqlDbType.Char, 5, "CustomerID");
adapter.UpdateCommand.Parameters.Add("@CompanyName",
SqlDbType.VarChar, 40, "CompanyName");
adapter.UpdateCommand.Parameters.Add("@oldCustomerID",
SqlDbType.Char, 5, "CustomerID").SourceVersion = DataRowVersion.Original;
adapter.DeleteCommand.Parameters.Add("@CustomerID",
SqlDbType.Char, 5, "CustomerID").SourceVersion = DataRowVersion.Original;
return adapter;
}
Public Function CreateSqlDataAdapter(ByVal commandText As String, _
ByVal connection As SqlConnection) As SqlDataAdapter
Dim adapter As New SqlDataAdapter(commandText, connection)
adapter.MissingSchemaAction = MissingSchemaAction.AddWithKey
' Create the commands.
adapter.InsertCommand = New SqlCommand( _
"INSERT INTO Customers (CustomerID, CompanyName) " & _
"VALUES (@CustomerID, @CompanyName)")
adapter.UpdateCommand = New SqlCommand( _
"UPDATE Customers SET CustomerID = @CustomerID, CompanyName = @CompanyName " & _
"WHERE CustomerID = @oldCustomerID")
adapter.DeleteCommand = New SqlCommand( _
"DELETE FROM Customers WHERE CustomerID = @CustomerID")
' Create the parameters.
adapter.InsertCommand.Parameters.Add("@CustomerID", _
SqlDbType.Char, 5, "CustomerID")
adapter.InsertCommand.Parameters.Add("@CompanyName", _
SqlDbType.VarChar, 40, "CompanyName")
adapter.UpdateCommand.Parameters.Add("@CustomerID", _
SqlDbType.Char, 5, "CustomerID")
adapter.UpdateCommand.Parameters.Add("@CompanyName", _
SqlDbType.VarChar, 40, "CompanyName")
adapter.UpdateCommand.Parameters.Add("@oldCustomerID", _
SqlDbType.Char, 5, "CustomerID").SourceVersion = DataRowVersion.Original
adapter.DeleteCommand.Parameters.Add("@CustomerID", _
SqlDbType.Char, 5, "CustomerID").SourceVersion = DataRowVersion.Original
Return adapter
End Function
Poznámky
Tato implementace SqlDataAdapter otevření a zavře SqlConnection , pokud ještě není otevřená. To může být užitečné v aplikaci, která musí volat metodu Fill pro dva nebo více SqlDataAdapter objektů. SqlConnection Pokud je již otevřená, musíte explicitně volat Zavřít nebo Dispose zavřít.
Při vytvoření instance jsou SqlDataAdapter následující vlastnosti pro čtení a zápis nastaveny na následující počáteční hodnoty.
| Vlastnosti | Počáteční hodnota |
|---|---|
| MissingMappingAction | MissingMappingAction.Passthrough |
| MissingSchemaAction | MissingSchemaAction.Add |
Hodnotu některé z těchto vlastností můžete změnit prostřednictvím samostatného volání vlastnosti.
Viz také
- Manipulace s daty (ADO.NET)
- Použití zprostředkovatele dat rozhraní .NET Framework pro SQL Server
- Přehled ADO.NET
Platí pro
SqlDataAdapter(String, String)
Inicializuje novou instanci SqlDataAdapter třídy pomocí SelectCommand připojovacího řetězce a připojovacího řetězce.
public:
SqlDataAdapter(System::String ^ selectCommandText, System::String ^ selectConnectionString);
public SqlDataAdapter(string selectCommandText, string selectConnectionString);
new System.Data.SqlClient.SqlDataAdapter : string * string -> System.Data.SqlClient.SqlDataAdapter
Public Sub New (selectCommandText As String, selectConnectionString As String)
Parametry
- selectCommandText
- String
Jedná String se o příkaz Transact-SQL SELECT nebo uloženou proceduru SelectCommand , která má být použita vlastností SqlDataAdapter.
- selectConnectionString
- String
Připojovací řetězec Pokud se připojovací řetězec nepoužívá Integrated Security = true, můžete použít SqlDataAdapter(String, SqlConnection) a SqlCredential bezpečně předat ID uživatele a heslo, než zadáním ID uživatele a hesla jako textu v připojovacím řetězci.
Příklady
Následující příklad vytvoří SqlDataAdapter a nastaví některé jeho vlastnosti.
public static SqlDataAdapter CreateSqlDataAdapter(string commandText,
string connectionString)
{
SqlDataAdapter adapter = new SqlDataAdapter(commandText, connectionString);
SqlConnection connection = adapter.SelectCommand.Connection;
adapter.MissingSchemaAction = MissingSchemaAction.AddWithKey;
// Create the commands.
adapter.InsertCommand = new SqlCommand(
"INSERT INTO Customers (CustomerID, CompanyName) " +
"VALUES (@CustomerID, @CompanyName)", connection);
adapter.UpdateCommand = new SqlCommand(
"UPDATE Customers SET CustomerID = @CustomerID, CompanyName = @CompanyName " +
"WHERE CustomerID = @oldCustomerID", connection);
adapter.DeleteCommand = new SqlCommand(
"DELETE FROM Customers WHERE CustomerID = @CustomerID", connection);
// Create the parameters.
adapter.InsertCommand.Parameters.Add("@CustomerID",
SqlDbType.Char, 5, "CustomerID");
adapter.InsertCommand.Parameters.Add("@CompanyName",
SqlDbType.VarChar, 40, "CompanyName");
adapter.UpdateCommand.Parameters.Add("@CustomerID",
SqlDbType.Char, 5, "CustomerID");
adapter.UpdateCommand.Parameters.Add("@CompanyName",
SqlDbType.VarChar, 40, "CompanyName");
adapter.UpdateCommand.Parameters.Add("@oldCustomerID",
SqlDbType.Char, 5, "CustomerID").SourceVersion = DataRowVersion.Original;
adapter.DeleteCommand.Parameters.Add("@CustomerID",
SqlDbType.Char, 5, "CustomerID").SourceVersion = DataRowVersion.Original;
return adapter;
}
Public Function CreateSqlDataAdapter(ByVal commandText As String, _
ByVal connectionString As String) As SqlDataAdapter
Dim adapter As New SqlDataAdapter(commandText, connectionString)
Dim connection As SqlConnection = adapter.SelectCommand.Connection
adapter.MissingSchemaAction = MissingSchemaAction.AddWithKey
' Create the commands.
adapter.InsertCommand = New SqlCommand( _
"INSERT INTO Customers (CustomerID, CompanyName) " & _
"VALUES (@CustomerID, @CompanyName)", connection)
adapter.UpdateCommand = New SqlCommand( _
"UPDATE Customers SET CustomerID = @CustomerID, CompanyName = @CompanyName " & _
"WHERE CustomerID = @oldCustomerID", connection)
adapter.DeleteCommand = New SqlCommand( _
"DELETE FROM Customers WHERE CustomerID = @CustomerID", connection)
' Create the parameters.
adapter.InsertCommand.Parameters.Add("@CustomerID", _
SqlDbType.Char, 5, "CustomerID")
adapter.InsertCommand.Parameters.Add("@CompanyName", _
SqlDbType.VarChar, 40, "CompanyName")
adapter.UpdateCommand.Parameters.Add("@CustomerID", _
SqlDbType.Char, 5, "CustomerID")
adapter.UpdateCommand.Parameters.Add("@CompanyName", _
SqlDbType.VarChar, 40, "CompanyName")
adapter.UpdateCommand.Parameters.Add("@oldCustomerID", _
SqlDbType.Char, 5, "CustomerID").SourceVersion = DataRowVersion.Original
adapter.DeleteCommand.Parameters.Add("@CustomerID", _
SqlDbType.Char, 5, "CustomerID").SourceVersion = DataRowVersion.Original
Return adapter
End Function
Poznámky
Toto přetížení konstruktoru SqlDataAdapterselectCommandText používá parametr k nastavení SelectCommand vlastnosti. Vytvoří SqlDataAdapter a zachová připojení vytvořené pomocí parametru selectConnectionString .
Při vytvoření instance jsou SqlDataAdapter následující vlastnosti pro čtení a zápis nastaveny na následující počáteční hodnoty.
| Vlastnosti | Počáteční hodnota |
|---|---|
| MissingMappingAction | MissingMappingAction.Passthrough |
| MissingSchemaAction | MissingSchemaAction.Add |
Hodnotu kterékoli z těchto vlastností můžete změnit prostřednictvím samostatného volání vlastnosti.
Viz také
- Manipulace s daty (ADO.NET)
- Použití zprostředkovatele dat rozhraní .NET Framework pro SQL Server
- Přehled ADO.NET