SqlParameter Klasa

Definicja

Przestrzeń nazw:

System.Data.SqlClient

Zestaw:

System.Data.dll

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 i typów danych parametrów.

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

[System.ComponentModel.TypeConverter(typeof(System.Data.SqlClient.SqlParameter+SqlParameterConverter))]
public sealed class SqlParameter : System.Data.Common.DbParameter, ICloneable

[<System.ComponentModel.TypeConverter(typeof(System.Data.SqlClient.SqlParameter+SqlParameterConverter))>]
type SqlParameter = class
    inherit DbParameter
    interface IDbDataParameter
    interface IDataParameter
    interface ICloneable

Public NotInheritable Class SqlParameter
Inherits DbParameter
Implements ICloneable

Dziedziczenie

Object

MarshalByRefObject

DbParameter

SqlParameter

Atrybuty

TypeConverterAttribute

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 oraz Konfigurowanie parametrów i typów danych parametrów.

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);
}

Public Sub 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)
End Sub

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 programu .NET Framework dla programu 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 funkcji Always Encrypted. Jeśli program 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ą naruszony program SQL Server zapewniający klientowi nieprawidłowe metadane 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 elementu Value.
SourceColumnNullMapping	Pobiera lub ustawia 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 wartość DataRowVersion 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

CreateObjRef(Type)	Tworzy obiekt zawierający wszystkie istotne informacje wymagane do wygenerowania serwera proxy używanego do komunikowania się z obiektem zdalnym. (Odziedziczone po MarshalByRefObject)
Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetLifetimeService()	Pobiera bieżący obiekt usługi okresu istnienia, który kontroluje zasady okresu istnienia dla tego wystąpienia. (Odziedziczone po MarshalByRefObject)
GetType()	Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object)
InitializeLifetimeService()	Uzyskuje obiekt usługi okresu istnienia w celu kontrolowania zasad okresu istnienia dla tego wystąpienia. (Odziedziczone po MarshalByRefObject)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
MemberwiseClone(Boolean)	Tworzy płytkią kopię bieżącego MarshalByRefObject obiektu. (Odziedziczone po MarshalByRefObject)
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().
IDbDataParameter.Precision	Wskazuje dokładność parametrów liczbowych. (Odziedziczone po DbParameter)
IDbDataParameter.Scale	Aby uzyskać opis tego członka, zobacz Scale. (Odziedziczone po DbParameter)

Zobacz też

• SqlParameterCollection
• SqlCommand
• Polecenia i parametry
• Parametry elementu DataAdapter
• SQL Server i ADO.NET
• Omówienie ADO.NET