Udostępnij za pośrednictwem


SqlParameter Klasa

Definicja

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
[System.ComponentModel.TypeConverter(typeof(Microsoft.Data.SqlClient.SqlParameter+SqlParameterConverter))]
public sealed class SqlParameter : System.Data.Common.DbParameter, ICloneable
public sealed class SqlParameter : System.Data.Common.DbParameter, ICloneable
[<System.ComponentModel.TypeConverter(typeof(Microsoft.Data.SqlClient.SqlParameter+SqlParameterConverter))>]
type SqlParameter = class
    inherit DbParameter
    interface IDbDataParameter
    interface IDataParameter
    interface ICloneable
type SqlParameter = class
    inherit DbParameter
    interface IDataParameter
    interface IDbDataParameter
    interface ICloneable
Public NotInheritable Class SqlParameter
Inherits DbParameter
Implements ICloneable
Dziedziczenie
SqlParameter
Atrybuty
Implementuje

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().

Dotyczy

Zobacz też