SqlParameterCollection.AddWithValue(String, Object) Methode

Definition

Namespace:

Microsoft.Data.SqlClient

Assembly:

Microsoft.Data.SqlClient.dll

Paket:

Microsoft.Data.SqlClient v5.2.0

Fügt am Ende der SqlParameterCollection einen Wert hinzu.

public:
 Microsoft::Data::SqlClient::SqlParameter ^ AddWithValue(System::String ^ parameterName, System::Object ^ value);

public Microsoft.Data.SqlClient.SqlParameter AddWithValue (string parameterName, object value);

member this.AddWithValue : string * obj -> Microsoft.Data.SqlClient.SqlParameter

Public Function AddWithValue (parameterName As String, value As Object) As SqlParameter

Parameter

parameterName

String

Der Name des Parameters.

value

Object

Der hinzuzufügende Wert. Verwenden Sie Value anstelle von NULL, um einen NULL-Wert anzugeben.

Gibt zurück

SqlParameter

Ein SqlParameter-Objekt.

Beispiele

Im folgenden Beispiel wird die Verwendung der AddWithValue-Methode veranschaulicht.

using System;
using System.Data;
using Microsoft.Data.SqlClient;


class Program
{
    static void Main()
    {
        string connectionString = GetConnectionString();
        string demo = @"<StoreSurvey xmlns=""http://schemas.microsoft.com/sqlserver/2004/07/adventure-works/StoreSurvey""><AnnualSales>1500000</AnnualSales><AnnualRevenue>150000</AnnualRevenue><BankName>Primary International</BankName><BusinessType>OS</BusinessType><YearOpened>1974</YearOpened><Specialty>Road</Specialty><SquareFeet>38000</SquareFeet><Brands>3</Brands><Internet>DSL</Internet><NumberEmployees>40</NumberEmployees></StoreSurvey>";
        Int32 id = 3;
        UpdateDemographics(id, demo, connectionString);
        Console.ReadLine();
    }
    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);
            }
        }
    }

Hinweise

AddWithValue ersetzt die -Methode, die SqlParameterCollection.Add ein String und ein Objectakzeptiert. Die Überladung von, Add die eine Zeichenfolge akzeptiert, und ein Objekt wurde aufgrund möglicher Mehrdeutigkeit mit der Überladung, die SqlParameterCollection.Add einen String akzeptiert, und einem SqlDbType Enumerationswert als veraltet gekennzeichnet, wobei das Übergeben einer ganzen Zahl mit der Zeichenfolge entweder als Parameterwert oder als entsprechenden SqlDbType Wert interpretiert werden kann. Verwenden Sie AddWithValue , wenn Sie einen Parameter hinzufügen möchten, indem Sie dessen Namen und Wert angeben.

Für SqlDbTypeXml Enumerationswerte können Sie eine Zeichenfolge, einen XML-Wert, einen XmlReader abgeleiteten Typ instance oder ein SqlXml -Objekt verwenden.