SqlParameter Klasa

Definicja

Przestrzeń nazw:

Microsoft.Data.SqlClient

Zestaw:

Microsoft.Data.SqlClient.dll

Pakiet:

Microsoft.Data.SqlClient v5.2.0

Reprezentuje parametr do elementu SqlCommand i opcjonalnie jego mapowanie na DataSet kolumny. Klasa ta nie może być dziedziczona. Aby uzyskać więcej informacji na temat parametrów, zobacz Konfigurowanie parametrów.

public ref class SqlParameter sealed : System::Data::Common::DbParameter, ICloneable

public sealed class SqlParameter : System.Data.Common.DbParameter, ICloneable

type SqlParameter = class
    inherit DbParameter
    interface IDataParameter
    interface IDbDataParameter
    interface ICloneable

Public NotInheritable Class SqlParameter
Inherits DbParameter
Implements ICloneable

Dziedziczenie

DbParameter

SqlParameter

Implementuje

IDataParameter IDbDataParameter ICloneable

Przykłady

Poniższy przykład tworzy wiele wystąpień SqlParameter za pośrednictwem SqlParameterCollection kolekcji w obiekcie SqlDataAdapter. Te parametry służą do wybierania danych ze źródła danych i umieszczania danych w elemecie DataSet. W tym przykładzie przyjęto założenie, że element DataSet i SqlDataAdapter został już utworzony przy użyciu odpowiedniego schematu, poleceń i połączenia. Aby uzyskać więcej informacji i dodatkowe przykłady dotyczące używania parametrów, zobacz Pobieranie i modyfikowanie danych w ADO.NET i Konfigurowanie parametrów.

using Microsoft.Data.SqlClient;
using System.Xml;
using System.Data.Common;
using System.Windows.Forms;

public class Form1 : Form
{
    protected DataSet categoriesDataSet;
    protected DataGrid dataGrid1;
    protected SqlDataAdapter categoriesAdapter;


    public void AddSqlParameters()
    {
        // ...
        // create categoriesDataSet and categoriesAdapter
        // ...

        categoriesAdapter.SelectCommand.Parameters.Add(
          "@CategoryName", SqlDbType.VarChar, 80).Value = "toasters";
        categoriesAdapter.SelectCommand.Parameters.Add(
          "@SerialNum", SqlDbType.Int).Value = 239;
        categoriesAdapter.Fill(categoriesDataSet);

    }
}

Uwagi

W nazwach parametrów nie jest uwzględniana wielkość liter.

Uwaga

Parametry bez nazw, nazywane również porządkowe, nie są obsługiwane przez dostawcę danych .NET Framework dla SQL Server.

Aby uzyskać więcej informacji, wraz z dodatkowym przykładowym kodem pokazującym sposób używania parametrów, zobacz Polecenia i parametry.

Konstruktory

SqlParameter()	Inicjuje nowe wystąpienie klasy SqlParameter.
SqlParameter(String, Object)	Inicjuje SqlParameter nowe wystąpienie klasy, które używa nazwy parametru i wartości nowego SqlParameter.
SqlParameter(String, SqlDbType)	Inicjuje SqlParameter nowe wystąpienie klasy, które używa nazwy parametru i typu danych.
SqlParameter(String, SqlDbType, Int32)	Inicjuje SqlParameter nowe wystąpienie klasy, które używa nazwy parametru , SqlDbTypei rozmiaru.
SqlParameter(String, SqlDbType, Int32, ParameterDirection, Boolean, Byte, Byte, String, DataRowVersion, Object)	Inicjuje nowe wystąpienie SqlParameter klasy, które używa nazwy parametru, typu parametru, rozmiaru parametru, ParameterDirectionprecyzji parametru, skali parametru, kolumny źródłowej, DataRowVersion wartości do użycia i wartości parametru.
SqlParameter(String, SqlDbType, Int32, ParameterDirection, Byte, Byte, String, DataRowVersion, Boolean, Object, String, String, String)	Inicjuje nowe wystąpienie SqlParameter klasy, które używa nazwy parametru, typu parametru, długości parametru kierunku, dokładności, skali, nazwy kolumny źródłowej, jednej z DataRowVersion wartości, wartości logicznej mapowania kolumny źródłowej, wartości , nazwy SqlParameterbazy danych, w której znajduje się kolekcja schematów dla tego wystąpienia XML, jest właścicielem schematu relacyjnego, w którym znajduje się kolekcja schematów dla tego wystąpienia XML, oraz nazwa kolekcji schematów dla tego parametru.
SqlParameter(String, SqlDbType, Int32, String)	Inicjuje SqlParameter nowe wystąpienie klasy, które używa nazwy parametru , SqlDbType, rozmiaru i nazwy kolumny źródłowej.

Właściwości

CompareInfo	Pobiera lub ustawia CompareInfo obiekt, który definiuje sposób wykonywania porównań ciągów dla tego parametru.
DbType	Pobiera lub ustawia SqlDbType parametr .
Direction	Pobiera lub ustawia wartość wskazującą, czy parametr jest parametrem tylko wejściowym, wyjściowym, dwukierunkowym lub zwracanym parametrem procedury składowanej.
ForceColumnEncryption	Wymusza szyfrowanie parametru podczas korzystania z Always Encrypted. Jeśli SQL Server informuje sterownik, że parametr nie musi być zaszyfrowany, zapytanie używające parametru zakończy się niepowodzeniem. Ta właściwość zapewnia dodatkową ochronę przed atakami zabezpieczeń, które obejmują naruszone SQL Server dostarczanie klientom nieprawidłowych metadanych szyfrowania, co może prowadzić do ujawnienia danych.
IsNullable	Pobiera lub ustawia wartość wskazującą, czy parametr akceptuje wartości null. IsNullable Nie jest używany do sprawdzania poprawności wartości parametru i nie uniemożliwia wysyłania ani odbierania wartości null podczas wykonywania polecenia.
LocaleId	Pobiera lub ustawia identyfikator ustawień regionalnych określający konwencje i język dla określonego regionu.
Offset	Pobiera lub ustawia przesunięcie na Value właściwość .
ParameterName	Pobiera lub ustawia nazwę .SqlParameter
Precision	Pobiera lub ustawia maksymalną liczbę cyfr używanych do reprezentowania Value właściwości.
Scale	Pobiera lub ustawia liczbę miejsc dziesiętnych, do których Value jest rozpoznawana.
Size	Pobiera lub ustawia maksymalny rozmiar danych w kolumnie w bajtach.
SourceColumn	Pobiera lub ustawia nazwę kolumny źródłowej zamapowanej na DataSet element i używany do ładowania lub zwracania Value
SourceColumnNullMapping	Ustawia lub pobiera wartość, która wskazuje, czy kolumna źródłowa jest dopuszczana do wartości null. Dzięki temu można SqlCommandBuilder poprawnie wygenerować instrukcje aktualizacji dla kolumn dopuszczanych do wartości null.
SourceVersion	Pobiera lub ustawia DataRowVersion element do użycia podczas ładowania Value
SqlDbType	Pobiera lub ustawia SqlDbType parametr .
SqlValue	Pobiera lub ustawia wartość parametru jako typ SQL.
TypeName	Pobiera lub ustawia nazwę typu dla parametru z wartością tabeli.
UdtTypeName	Pobiera lub ustawia typ string , który reprezentuje typ zdefiniowany przez użytkownika jako parametr.
Value	Pobiera lub ustawia wartość parametru.
XmlSchemaCollectionDatabase	Pobiera nazwę bazy danych, w której znajduje się kolekcja schematów dla tego wystąpienia XML.
XmlSchemaCollectionName	Pobiera nazwę kolekcji schematów dla tego wystąpienia XML.
XmlSchemaCollectionOwningSchema	Schemat relacyjny, w którym znajduje się kolekcja schematów dla tego wystąpienia XML.

Metody

ResetDbType()	Resetuje typ skojarzony z tym SqlParameterelementem .
ResetSqlDbType()	Resetuje typ skojarzony z tym SqlParameterelementem .
ToString()	Pobiera ciąg zawierający element ParameterName.

Jawne implementacje interfejsu

ICloneable.Clone()

Aby uzyskać opis tego członka, zobacz Clone().

Zobacz też

• SqlParameterCollection
• SqlCommand