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

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

SourceVersion

Pobiera lub ustawia wartość DataRowVersion do użycia podczas ładowania Value.

(Odziedziczone po DbParameter)
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()
Przestarzałe.

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()
Przestarzałe.

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

IDataParameter.SourceVersion

Pobiera lub ustawia parametr DataRowVersion do użycia podczas ładowania Valueelementu .

(Odziedziczone po DbParameter)
IDbDataParameter.Precision

Wskazuje dokładność parametrów liczbowych.

(Odziedziczone po DbParameter)
IDbDataParameter.Scale

Aby uzyskać opis tego członka, zobacz Scale.

(Odziedziczone po DbParameter)

Dotyczy

Zobacz też