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.

W przypadku nowego programowania użyj Microsoft. Data.SqlClient. Ta strona zawiera dokumenty System.Data.SqlClient.

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 obiekcie 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 dodatkowych przykładów dotyczących używania parametrów, zobacz Retrieving and Modifying Data in ADO.NET and Configuring Parameters and Parameter Data Types.

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 rozróżniana wielkość liter.

Note

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

Nazwisko	Opis
SqlParameter()	Inicjuje nowe wystąpienie klasy SqlParameter. W przypadku nowego programowania użyj Microsoft. Data.SqlClient. Ta strona zawiera dokumenty System.Data.SqlClient.
SqlParameter(String, Object)	Inicjuje nowe wystąpienie SqlParameter klasy, która używa nazwy parametru i wartości nowego SqlParameter. W przypadku nowego programowania użyj Microsoft. Data.SqlClient. Ta strona zawiera dokumenty System.Data.SqlClient.
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, ParameterDirectiondokładności parametru, skali parametru, kolumny źródłowej, wartości DataRowVersion do użycia i wartości parametru. W przypadku nowego programowania użyj Microsoft. Data.SqlClient. Ta strona zawiera dokumenty System.Data.SqlClient.
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, własny schemat relacyjny, w którym znajduje się kolekcja schematów dla tego wystąpienia XML, oraz nazwa kolekcji schematów dla tego parametru. W przypadku nowego programowania użyj Microsoft. Data.SqlClient. Ta strona zawiera dokumenty System.Data.SqlClient.
SqlParameter(String, SqlDbType, Int32, String)	Inicjuje nowe wystąpienie SqlParameter klasy, które używa nazwy parametru , SqlDbType, rozmiaru i nazwy kolumny źródłowej. W przypadku nowego programowania użyj Microsoft. Data.SqlClient. Ta strona zawiera dokumenty System.Data.SqlClient.
SqlParameter(String, SqlDbType, Int32)	Inicjuje nowe wystąpienie SqlParameter klasy, która używa nazwy parametru SqlDbType, i rozmiaru. W przypadku nowego programowania użyj Microsoft. Data.SqlClient. Ta strona zawiera dokumenty System.Data.SqlClient.
SqlParameter(String, SqlDbType)	Inicjuje SqlParameter nowe wystąpienie klasy, która używa nazwy parametru i typu danych. W przypadku nowego programowania użyj Microsoft. Data.SqlClient. Ta strona zawiera dokumenty System.Data.SqlClient.

Właściwości

Nazwisko	Opis
CompareInfo	Pobiera lub ustawia CompareInfo obiekt definiujący sposób wykonywania porównań ciągów dla tego parametru. W przypadku nowego programowania użyj Microsoft. Data.SqlClient. Ta strona zawiera dokumenty System.Data.SqlClient.
DbType	Pobiera lub ustawia SqlDbType parametr . W przypadku nowego programowania użyj Microsoft. Data.SqlClient. Ta strona zawiera dokumenty System.Data.SqlClient.
Direction	Pobiera lub ustawia wartość wskazującą, czy parametr jest parametrem tylko wejściowym, wyjściowym, dwukierunkowym lub parametrem zwracanej wartości procedury składowanej. W przypadku nowego programowania użyj Microsoft. Data.SqlClient. Ta strona zawiera dokumenty System.Data.SqlClient.
ForceColumnEncryption	Wymusza szyfrowanie parametru podczas używania funkcji 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 niepoprawnych metadanych szyfrowania klientowi, co może prowadzić do ujawnienia danych. W przypadku nowego programowania użyj Microsoft. Data.SqlClient. Ta strona zawiera dokumenty System.Data.SqlClient.
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. W przypadku nowego programowania użyj Microsoft. Data.SqlClient. Ta strona zawiera dokumenty System.Data.SqlClient.
LocaleId	Pobiera lub ustawia identyfikator ustawień regionalnych określający konwencje i język dla określonego regionu. W przypadku nowego programowania użyj Microsoft. Data.SqlClient. Ta strona zawiera dokumenty System.Data.SqlClient.
Offset	Pobiera lub ustawia przesunięcie na Value właściwość . W przypadku nowego programowania użyj Microsoft. Data.SqlClient. Ta strona zawiera dokumenty System.Data.SqlClient.
ParameterName	Pobiera lub ustawia nazwę SqlParameterelementu . W przypadku nowego programowania użyj Microsoft. Data.SqlClient. Ta strona zawiera dokumenty System.Data.SqlClient.
Precision	Pobiera lub ustawia maksymalną liczbę cyfr używanych do reprezentowania Value właściwości. W przypadku nowego programowania użyj Microsoft. Data.SqlClient. Ta strona zawiera dokumenty System.Data.SqlClient.
Scale	Pobiera lub ustawia liczbę miejsc dziesiętnych, do których Value jest rozpoznawana. W przypadku nowego programowania użyj Microsoft. Data.SqlClient. Ta strona zawiera dokumenty System.Data.SqlClient.
Size	Pobiera lub ustawia maksymalny rozmiar danych w bajtach w kolumnie. W przypadku nowego programowania użyj Microsoft. Data.SqlClient. Ta strona zawiera dokumenty System.Data.SqlClient.
SourceColumn	Pobiera lub ustawia nazwę kolumny źródłowej zamapowanej na DataSet element i używany do ładowania lub zwracania elementu Value. W przypadku nowego programowania użyj Microsoft. Data.SqlClient. Ta strona zawiera dokumenty System.Data.SqlClient.
SourceColumnNullMapping	Pobiera lub ustawia wartość wskazującą, czy kolumna źródłowa ma wartość null. Dzięki temu można SqlCommandBuilder poprawnie wygenerować instrukcje aktualizacji dla kolumn dopuszczanych do wartości null. W przypadku nowego programowania użyj Microsoft. Data.SqlClient. Ta strona zawiera dokumenty System.Data.SqlClient.
SourceVersion	Pobiera lub ustawia parametr DataRowVersion do użycia podczas ładowania Value. W przypadku nowego programowania użyj Microsoft. Data.SqlClient. Ta strona zawiera dokumenty System.Data.SqlClient.
SqlDbType	Pobiera lub ustawia SqlDbType parametr . W przypadku nowego programowania użyj Microsoft. Data.SqlClient. Ta strona zawiera dokumenty System.Data.SqlClient.
SqlValue	Pobiera lub ustawia wartość parametru jako typ SQL. W przypadku nowego programowania użyj Microsoft. Data.SqlClient. Ta strona zawiera dokumenty System.Data.SqlClient.
TypeName	Pobiera lub ustawia nazwę typu dla parametru wartości tabeli. W przypadku nowego programowania użyj Microsoft. Data.SqlClient. Ta strona zawiera dokumenty System.Data.SqlClient.
UdtTypeName	Pobiera lub ustawia typ string zdefiniowany przez użytkownika jako parametr. W przypadku nowego programowania użyj Microsoft. Data.SqlClient. Ta strona zawiera dokumenty System.Data.SqlClient.
Value	Pobiera lub ustawia wartość parametru. W przypadku nowego programowania użyj Microsoft. Data.SqlClient. Ta strona zawiera dokumenty System.Data.SqlClient.
XmlSchemaCollectionDatabase	Pobiera nazwę bazy danych, w której znajduje się kolekcja schematów dla tego wystąpienia XML. W przypadku nowego programowania użyj Microsoft. Data.SqlClient. Ta strona zawiera dokumenty System.Data.SqlClient.
XmlSchemaCollectionName	Pobiera nazwę kolekcji schematów dla tego wystąpienia XML. W przypadku nowego programowania użyj Microsoft. Data.SqlClient. Ta strona zawiera dokumenty System.Data.SqlClient.
XmlSchemaCollectionOwningSchema	Schemat relacyjny, w którym znajduje się kolekcja schematów dla tego wystąpienia XML. W przypadku nowego programowania użyj Microsoft. Data.SqlClient. Ta strona zawiera dokumenty System.Data.SqlClient.

Metody

Nazwisko	Opis
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 określony obiekt jest równy bieżącemu obiektowi. (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()	Pobiera Type 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 Object. (Odziedziczone po Object)
MemberwiseClone(Boolean)	Tworzy płytkią kopię bieżącego MarshalByRefObject obiektu. (Odziedziczone po MarshalByRefObject)
ResetDbType()	Resetuje typ skojarzony z tym SqlParameterelementem . W przypadku nowego programowania użyj Microsoft. Data.SqlClient. Ta strona zawiera dokumenty System.Data.SqlClient.
ResetSqlDbType()	Resetuje typ skojarzony z tym SqlParameterelementem . W przypadku nowego programowania użyj Microsoft. Data.SqlClient. Ta strona zawiera dokumenty System.Data.SqlClient.
ToString()	Pobiera ciąg zawierający element ParameterName. W przypadku nowego programowania użyj Microsoft. Data.SqlClient. Ta strona zawiera dokumenty System.Data.SqlClient.

Jawne implementacje interfejsu

Nazwisko	Opis
ICloneable.Clone()	Aby uzyskać opis tego elementu członkowskiego, zobacz Clone(). W przypadku nowego programowania użyj Microsoft. Data.SqlClient. Ta strona zawiera dokumenty System.Data.SqlClient.
IDbDataParameter.Precision	Wskazuje dokładność parametrów liczbowych. (Odziedziczone po DbParameter)
IDbDataParameter.Scale	Aby uzyskać opis tego elementu członkowskiego, zobacz Scale. (Odziedziczone po DbParameter)

Zobacz też

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