SqlDataAdapter Costruttori
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Inizializza una nuova istanza della classe SqlDataAdapter.
Overload
| Nome | Descrizione |
|---|---|
| SqlDataAdapter() |
Inizializza una nuova istanza della classe SqlDataAdapter. |
| SqlDataAdapter(SqlCommand) |
Inizializza una nuova istanza della SqlDataAdapter classe con l'oggetto specificato SqlCommand come SelectCommand proprietà . |
| SqlDataAdapter(String, SqlConnection) |
Inizializza una nuova istanza della SqlDataAdapter classe con un SelectCommand oggetto e .SqlConnection |
| SqlDataAdapter(String, String) |
Inizializza una nuova istanza della SqlDataAdapter classe con e SelectCommand una stringa di connessione. |
SqlDataAdapter()
Inizializza una nuova istanza della classe SqlDataAdapter.
public:
SqlDataAdapter();
public SqlDataAdapter();
Public Sub New ()
Esempio
Nell'esempio seguente viene creato un SqlDataAdapter oggetto e vengono impostate alcune delle relative proprietà.
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
Commenti
Quando viene creata un'istanza di , le proprietà di SqlDataAdapter lettura/scrittura seguenti vengono impostate sui valori iniziali seguenti.
| Proprietà | Valore iniziale |
|---|---|
| MissingMappingAction | MissingMappingAction.Passthrough |
| MissingSchemaAction | MissingSchemaAction.Add |
È possibile modificare il valore di una di queste proprietà tramite una chiamata separata alla proprietà .
Vedi anche
- Modifica dei dati (ADO.NET)
- Uso del provider di dati .NET Framework per SQL Server
- Panoramica di ADO.NET
Si applica a
SqlDataAdapter(SqlCommand)
Inizializza una nuova istanza della SqlDataAdapter classe con l'oggetto specificato SqlCommand come SelectCommand proprietà .
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)
Parametri
- selectCommand
- SqlCommand
Oggetto SqlCommand che è un'istruzione SELECT Transact-SQL o una stored procedure e viene impostata come SelectCommand proprietà dell'oggetto SqlDataAdapter.
Esempio
Nell'esempio seguente viene creato un SqlDataAdapter oggetto e vengono impostate alcune delle relative proprietà.
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
Commenti
Questa implementazione del SqlDataAdapter costruttore imposta la SelectCommand proprietà sul valore specificato nel selectCommand parametro .
Quando viene creata un'istanza di , le proprietà di SqlDataAdapter lettura/scrittura seguenti vengono impostate sui valori iniziali seguenti.
| Proprietà | Valore iniziale |
|---|---|
| MissingMappingAction | MissingMappingAction.Passthrough |
| MissingSchemaAction | MissingSchemaAction.Add |
È possibile modificare il valore di una di queste proprietà tramite una chiamata separata alla proprietà .
Quando SelectCommand (o una delle altre proprietà del comando) viene assegnato a un oggetto creato SqlCommandin precedenza , l'oggetto SqlCommand non viene clonato. SelectCommand Mantiene un riferimento all'oggetto creato SqlCommand in precedenza.
Vedi anche
- Modifica dei dati (ADO.NET)
- Uso del provider di dati .NET Framework per SQL Server
- Panoramica di ADO.NET
Si applica a
SqlDataAdapter(String, SqlConnection)
Inizializza una nuova istanza della SqlDataAdapter classe con un SelectCommand oggetto e .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)
Parametri
- selectCommandText
- String
Oggetto String che rappresenta un'istruzione SELECT Transact-SQL o una stored procedure da utilizzare dalla SelectCommand proprietà dell'oggetto SqlDataAdapter.
- selectConnection
- SqlConnection
Oggetto SqlConnection che rappresenta la connessione. Se la stringa di connessione non usa Integrated Security = true, è possibile usare SqlCredential per passare l'ID utente e la password in modo più sicuro rispetto a specificando l'ID utente e la password come testo nella stringa di connessione.
Esempio
Nell'esempio seguente viene creato un SqlDataAdapter oggetto e vengono impostate alcune delle relative proprietà.
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
Commenti
Questa implementazione di SqlDataAdapter viene aperta e chiusa se SqlConnection non è già aperta. Può essere utile in un'applicazione che deve chiamare il Fill metodo per due o più SqlDataAdapter oggetti. Se è SqlConnection già aperto, è necessario chiamare in modo esplicito Close o Dispose per chiuderlo.
Quando viene creata un'istanza di , le proprietà di SqlDataAdapter lettura/scrittura seguenti vengono impostate sui valori iniziali seguenti.
| Proprietà | Valore iniziale |
|---|---|
| MissingMappingAction | MissingMappingAction.Passthrough |
| MissingSchemaAction | MissingSchemaAction.Add |
È possibile modificare il valore di una di queste proprietà tramite una chiamata separata alla proprietà .
Vedi anche
- Modifica dei dati (ADO.NET)
- Uso del provider di dati .NET Framework per SQL Server
- Panoramica di ADO.NET
Si applica a
SqlDataAdapter(String, String)
Inizializza una nuova istanza della SqlDataAdapter classe con e SelectCommand una stringa di connessione.
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)
Parametri
- selectCommandText
- String
Oggetto String che rappresenta un'istruzione SELECT Transact-SQL o una stored procedure da utilizzare dalla SelectCommand proprietà dell'oggetto SqlDataAdapter.
- selectConnectionString
- String
La stringa di connessione. Se la stringa di connessione non usa Integrated Security = true, è possibile usare SqlDataAdapter(String, SqlConnection) e SqlCredential per passare l'ID utente e la password in modo più sicuro rispetto a specificando l'ID utente e la password come testo nella stringa di connessione.
Esempio
Nell'esempio seguente viene creato un SqlDataAdapter oggetto e vengono impostate alcune delle relative proprietà.
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
Commenti
Questo overload del SqlDataAdapter costruttore usa il selectCommandText parametro per impostare la SelectCommand proprietà .
SqlDataAdapter verrà creata e gestita la connessione creata con il selectConnectionString parametro .
Quando viene creata un'istanza di , le proprietà di SqlDataAdapter lettura/scrittura seguenti vengono impostate sui valori iniziali seguenti.
| Proprietà | Valore iniziale |
|---|---|
| MissingMappingAction | MissingMappingAction.Passthrough |
| MissingSchemaAction | MissingSchemaAction.Add |
È possibile modificare il valore di una di queste proprietà tramite una chiamata separata alla proprietà .
Vedi anche
- Modifica dei dati (ADO.NET)
- Uso del provider di dati .NET Framework per SQL Server
- Panoramica di ADO.NET