SqlParameterCollection.AddWithValue(String, Object) Metodo
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.
Aggiunge un valore alla fine del SqlParameterCollection.
public:
System::Data::SqlClient::SqlParameter ^ AddWithValue(System::String ^ parameterName, System::Object ^ value);
public System.Data.SqlClient.SqlParameter AddWithValue (string parameterName, object value);
member this.AddWithValue : string * obj -> System.Data.SqlClient.SqlParameter
Public Function AddWithValue (parameterName As String, value As Object) As SqlParameter
Parametri
- parameterName
- String
Nome del parametro.
Restituisce
Oggetto SqlParameter.
Esempio
Nell'esempio seguente viene illustrato come usare il metodo AddWithValue
.
private static void UpdateDemographics(Int32 customerID,
string demoXml, string connectionString)
{
// Update the demographics for a store, which is stored
// in an xml column.
string commandText = "UPDATE Sales.Store SET Demographics = @demographics "
+ "WHERE CustomerID = @ID;";
using (SqlConnection connection = new SqlConnection(connectionString))
{
SqlCommand command = new SqlCommand(commandText, connection);
command.Parameters.Add("@ID", SqlDbType.Int);
command.Parameters["@ID"].Value = customerID;
// Use AddWithValue to assign Demographics.
// SQL Server will implicitly convert strings into XML.
command.Parameters.AddWithValue("@demographics", demoXml);
try
{
connection.Open();
Int32 rowsAffected = command.ExecuteNonQuery();
Console.WriteLine("RowsAffected: {0}", rowsAffected);
}
catch (Exception ex)
{
Console.WriteLine(ex.Message);
}
}
}
Private Sub UpdateDemographics(ByVal customerID As Integer, _
ByVal demoXml As String, _
ByVal connectionString As String)
' Update the demographics for a store, which is stored
' in an xml column.
Dim commandText As String = _
"UPDATE Sales.Store SET Demographics = @demographics " _
& "WHERE CustomerID = @ID;"
Using connection As New SqlConnection(connectionString)
Dim command As New SqlCommand(commandText, connection)
' Add CustomerID parameter for WHERE clause.
command.Parameters.Add("@ID", SqlDbType.Int)
command.Parameters("@ID").Value = customerID
' Use AddWithValue to assign Demographics.
' SQL Server will implicitly convert strings into XML.
command.Parameters.AddWithValue("@demographics", demoXml)
Try
connection.Open()
Dim rowsAffected As Integer = command.ExecuteNonQuery()
Console.WriteLine("RowsAffected: {0}", rowsAffected)
Catch ex As Exception
Console.WriteLine(ex.Message)
End Try
End Using
End Sub
Commenti
AddWithValue sostituisce il metodo SqlParameterCollection.Add
che accetta un String e un Object. L'overload di Add
che accetta una stringa e un oggetto è stato deprecato a causa di possibili ambiguità con l'overload SqlParameterCollection.Add
che accetta un String e un valore di enumerazione SqlDbType in cui il passaggio di un numero intero con la stringa può essere interpretato come il valore del parametro o il valore SqlDbType corrispondente. Usare AddWithValue ogni volta che si desidera aggiungere un parametro specificandone il nome e il valore.
Per SqlDbTypeXml
valori di enumerazione, è possibile utilizzare una stringa, un valore XML, un XmlReader'istanza del tipo derivato o un oggetto SqlXml.
Si applica a
Vedi anche
- comandi e parametri
(ADO.NET) - ADO.NET
DataAdapter - uso del provider di dati .NET Framework per SQL Server
- ADO.NET Panoramica