SqlParameter Klasa
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
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
public ref class SqlParameter sealed : System::Data::Common::DbParameter
public ref class SqlParameter sealed : MarshalByRefObject, ICloneable, System::Data::IDbDataParameter
public sealed class SqlParameter : System.Data.Common.DbParameter, ICloneable
[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
[System.ComponentModel.TypeConverter(typeof(System.Data.SqlClient.SqlParameterConverter))]
public sealed class SqlParameter : MarshalByRefObject, ICloneable, System.Data.IDbDataParameter
type SqlParameter = class
inherit DbParameter
interface ICloneable
[<System.ComponentModel.TypeConverter(typeof(System.Data.SqlClient.SqlParameter+SqlParameterConverter))>]
type SqlParameter = class
inherit DbParameter
interface 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
Public NotInheritable Class SqlParameter
Inherits DbParameter
Implements ICloneable
Public NotInheritable Class SqlParameter
Inherits DbParameter
Public NotInheritable Class SqlParameter
Inherits MarshalByRefObject
Implements ICloneable, IDbDataParameter
- Dziedziczenie
- Dziedziczenie
- Dziedziczenie
- 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 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 |
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. |
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 zabezpieczającymi, które obejmują naruszone SQL Server dostarczanie niepoprawnych metadanych szyfrowania klientowi, co może prowadzić do ujawnienia danych. |
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. |
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 wartości tabeli. |
UdtTypeName |
Pobiera lub ustawia |
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 bieżące wystąpienie. (Odziedziczone po Object) |
InitializeLifetimeService() |
Przestarzałe.
Uzyskuje obiekt usługi okresu istnienia, aby kontrolować zasady 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 ParameterNameelement . |
Jawne implementacje interfejsu
ICloneable.Clone() |
Aby uzyskać opis tego elementu członkowskiego, zobacz Clone(). |
IDataParameter.SourceVersion |
Pobiera lub ustawia parametr DataRowVersion , który ma być używany podczas ładowania Value. (Odziedziczone po DbParameter) |
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) |
Dotyczy
Zobacz też
Opinia
https://aka.ms/ContentUserFeedback.
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź:Prześlij i wyświetl opinię dla