SqlParameter Klasa

Definicja

Przestrzeń nazw:

System.Data.SqlClient

Zestaw:

System.Data.SqlClient.dll

Pakiet:

System.Data.SqlClient v4.8.6

Reprezentuje parametr i SqlCommand opcjonalnie 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

DbParameter

SqlParameter

Atrybuty

TypeConverterAttribute

Implementuje

ICloneable IDataParameter IDbDataParameter

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 założono, ż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 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

Nazwy parametrów nie są uwzględniane wielkości liter.

Uwaga

Bez nazwy, nazywane również porządkowym, parametry 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 nowe wystąpienie klasy, które używa nazwy parametru SqlParameter , 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, , precyzji parametru, ParameterDirectionskali 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 SqlParameternazwy bazy danych, w której znajduje się kolekcja schematów dla tego wystąpienia XML, schemat relacyjny, 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 definiujący sposób porównywania 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 parametrem zwracanej wartości procedury składowanej.
IsNullable	Pobiera lub ustawia wartość wskazującą, czy parametr akceptuje wartości null. IsNullable Nie służy 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, który określa konwencje i język dla określonego regionu.
Offset	Pobiera lub ustawia przesunięcie do Value właściwości.
ParameterName	Pobiera lub ustawia nazwę elementu 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 bajtach w kolumnie.
SourceColumn	Pobiera lub ustawia nazwę kolumny źródłowej zamapowanej na DataSet element i używany do ładowania lub zwracania Valuewartości .
SourceColumnNullMapping	Pobiera lub ustawia wartość wskazującą, czy kolumna źródłowa ma wartość null. SqlCommandBuilder Umożliwia to poprawne generowanie instrukcji Update 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 wartości tabeli.
UdtTypeName	Pobiera lub ustawia string 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

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)
GetType()	Type Pobiera bieżące wystąpienie. (Odziedziczone po Object)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
ResetDbType()	Resetuje typ skojarzony z tym SqlParameterelementem .
ResetSqlDbType()	Resetuje typ skojarzony z tym SqlParameterelementem .
ToString()	Pobiera ciąg zawierający ParameterNameelement .

Jawne implementacje interfejsu

ICloneable.Clone()

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

Zobacz też

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