SqlParameter Klass

Definition

Namnområde:: System.Data.SqlClient

Sammansättning:: System.Data.SqlClient.dll

Sammansättning:: System.Data.dll

Källa:: System.Data.SqlClient.notsupported.cs

Viktigt

En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.

Representerar en parameter till en SqlCommand och eventuellt dess mappning till DataSet kolumner. Det går inte att ärva den här klassen. Mer information om parametrar finns i Konfigurera parametrar och parameterdatatyper.

Använd Microsoft för ny utveckling. Data.SqlClient. Den här sidan dokumenterar System.Data.SqlClient.

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

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

Public NotInheritable Class SqlParameter
Inherits MarshalByRefObject
Implements ICloneable, IDbDataParameter

Public NotInheritable Class SqlParameter
Inherits DbParameter
Implements ICloneable

Arv: Object

DbParameter
SqlParameter

Arv: Object

MarshalByRefObject

DbParameter
SqlParameter

Arv: Object

MarshalByRefObject
SqlParameter

Attribut: TypeConverterAttribute

Implementeringar: IDataParameter IDbDataParameter ICloneable

Exempel

I följande exempel skapas flera instanser av SqlParameter via SqlParameterCollection samlingen i SqlDataAdapter. Dessa parametrar används för att välja data från datakällan och placera data i DataSet. Det här exemplet förutsätter att en DataSet och en SqlDataAdapter redan har skapats med hjälp av lämpligt schema, kommandon och anslutning. Mer information och ytterligare exempel på hur du använder parametrar finns i 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

Kommentarer

Parameternamn är inte skiftlägeskänsliga.

Note

Namnlösa parametrar, även kallade ordningstal, stöds inte av .NET Framework-Data Provider för SQL Server.

Mer information, tillsammans med ytterligare exempelkod som visar hur du använder parametrar, finns i Kommandon och parametrar.

Konstruktorer

Name	Description
SqlParameter()	Initierar en ny instans av SqlParameter klassen. Använd Microsoft för ny utveckling. Data.SqlClient. Den här sidan dokumenterar System.Data.SqlClient.
SqlParameter(String, Object)	Initierar en ny instans av SqlParameter klassen som använder parameternamnet och värdet för den nya SqlParameter. Använd Microsoft för ny utveckling. Data.SqlClient. Den här sidan dokumenterar System.Data.SqlClient.
SqlParameter(String, SqlDbType, Int32, ParameterDirection, Boolean, Byte, Byte, String, DataRowVersion, Object)	Initierar en ny instans av SqlParameter klassen som använder parameternamnet, typen av parameter, parameterns storlek, en ParameterDirection, parameterns precision, parameterns skala, källkolumnen, en DataRowVersion att använda och värdet för parametern. Använd Microsoft för ny utveckling. Data.SqlClient. Den här sidan dokumenterar System.Data.SqlClient.
SqlParameter(String, SqlDbType, Int32, ParameterDirection, Byte, Byte, String, DataRowVersion, Boolean, Object, String, String, String)	Initierar en ny instans av SqlParameter klassen som använder parameternamnet, parametertypen, längden på parametern riktningen, precisionen, skalan, namnet på källkolumnen, ett av DataRowVersion värdena, ett booleskt värde för källkolumnmappning, värdet `SqlParameter`för , namnet på databasen där schemasamlingen för den här XML-instansen finns. det ägande relationsschemat där schemasamlingen för den här XML-instansen finns och namnet på schemasamlingen för den här parametern. Använd Microsoft för ny utveckling. Data.SqlClient. Den här sidan dokumenterar System.Data.SqlClient.
SqlParameter(String, SqlDbType, Int32, String)	Initierar en ny instans av SqlParameter klassen som använder parameternamnet, SqlDbType, storleken och källkolumnnamnet. Använd Microsoft för ny utveckling. Data.SqlClient. Den här sidan dokumenterar System.Data.SqlClient.
SqlParameter(String, SqlDbType, Int32)	Initierar en ny instans av SqlParameter klassen som använder parameternamnet, SqlDbType, och storleken. Använd Microsoft för ny utveckling. Data.SqlClient. Den här sidan dokumenterar System.Data.SqlClient.
SqlParameter(String, SqlDbType)	Initierar en ny instans av SqlParameter klassen som använder parameternamnet och datatypen. Använd Microsoft för ny utveckling. Data.SqlClient. Den här sidan dokumenterar System.Data.SqlClient.

Egenskaper

Name	Description
CompareInfo	Hämtar eller anger det CompareInfo objekt som definierar hur strängjämförelser ska utföras för den här parametern. Använd Microsoft för ny utveckling. Data.SqlClient. Den här sidan dokumenterar System.Data.SqlClient.
DbType	Hämtar eller anger SqlDbType parametern . Använd Microsoft för ny utveckling. Data.SqlClient. Den här sidan dokumenterar System.Data.SqlClient.
Direction	Hämtar eller anger ett värde som anger om parametern endast är indata, endast utdata, dubbelriktad eller en returnerarvärdeparameter för lagrad procedur. Använd Microsoft för ny utveckling. Data.SqlClient. Den här sidan dokumenterar System.Data.SqlClient.
ForceColumnEncryption	Framtvingar kryptering av en parameter när always encrypted används. Om SQL Server informerar drivrutinen om att parametern inte behöver krypteras misslyckas frågan med parametern . Den här egenskapen ger ytterligare skydd mot säkerhetsattacker som omfattar en komprometterad SQL Server att tillhandahålla felaktiga krypteringsmetadata till klienten, vilket kan leda till att data avslöjas. Använd Microsoft för ny utveckling. Data.SqlClient. Den här sidan dokumenterar System.Data.SqlClient.
IsNullable	Hämtar eller anger ett värde som anger om parametern accepterar null-värden. IsNullable används inte för att verifiera parameterns värde och förhindrar inte att ett null-värde skickas eller tas emot när ett kommando körs. Använd Microsoft för ny utveckling. Data.SqlClient. Den här sidan dokumenterar System.Data.SqlClient.
LocaleId	Hämtar eller anger språkidentifieraren som avgör konventioner och språk för en viss region. Använd Microsoft för ny utveckling. Data.SqlClient. Den här sidan dokumenterar System.Data.SqlClient.
Offset	Hämtar eller anger förskjutningen till Value egenskapen. Använd Microsoft för ny utveckling. Data.SqlClient. Den här sidan dokumenterar System.Data.SqlClient.
ParameterName	Hämtar eller anger namnet på SqlParameter. Använd Microsoft för ny utveckling. Data.SqlClient. Den här sidan dokumenterar System.Data.SqlClient.
Precision	Hämtar eller anger det maximala antalet siffror som används för att representera Value egenskapen. Använd Microsoft för ny utveckling. Data.SqlClient. Den här sidan dokumenterar System.Data.SqlClient.
Scale	Hämtar eller anger antalet decimaler som Value har lösts. Använd Microsoft för ny utveckling. Data.SqlClient. Den här sidan dokumenterar System.Data.SqlClient.
Size	Hämtar eller anger den maximala storleken, i byte, på data i kolumnen. Använd Microsoft för ny utveckling. Data.SqlClient. Den här sidan dokumenterar System.Data.SqlClient.
SourceColumn	Hämtar eller anger namnet på källkolumnen som mappats till och används för att DataSet läsa in eller returnera Value. Använd Microsoft för ny utveckling. Data.SqlClient. Den här sidan dokumenterar System.Data.SqlClient.
SourceColumnNullMapping	Hämtar eller anger ett värde som anger om källkolumnen är nullbar. På så sätt kan SqlCommandBuilder du generera uppdateringsinstruktioner för null-kolumner på rätt sätt. Använd Microsoft för ny utveckling. Data.SqlClient. Den här sidan dokumenterar System.Data.SqlClient.
SourceVersion	Hämtar eller ställer in som DataRowVersion ska användas när du läser in Value. Använd Microsoft för ny utveckling. Data.SqlClient. Den här sidan dokumenterar System.Data.SqlClient.
SqlDbType	Hämtar eller anger SqlDbType parametern . Använd Microsoft för ny utveckling. Data.SqlClient. Den här sidan dokumenterar System.Data.SqlClient.
SqlValue	Hämtar eller anger värdet för parametern som en SQL-typ. Använd Microsoft för ny utveckling. Data.SqlClient. Den här sidan dokumenterar System.Data.SqlClient.
TypeName	Hämtar eller anger typnamnet för en tabellvärdesparameter. Använd Microsoft för ny utveckling. Data.SqlClient. Den här sidan dokumenterar System.Data.SqlClient.
UdtTypeName	Hämtar eller anger en `string` som representerar en användardefinierad typ som en parameter. Använd Microsoft för ny utveckling. Data.SqlClient. Den här sidan dokumenterar System.Data.SqlClient.
Value	Hämtar eller anger värdet för parametern. Använd Microsoft för ny utveckling. Data.SqlClient. Den här sidan dokumenterar System.Data.SqlClient.
XmlSchemaCollectionDatabase	Hämtar namnet på databasen där schemasamlingen för den här XML-instansen finns. Använd Microsoft för ny utveckling. Data.SqlClient. Den här sidan dokumenterar System.Data.SqlClient.
XmlSchemaCollectionName	Hämtar namnet på schemasamlingen för den här XML-instansen. Använd Microsoft för ny utveckling. Data.SqlClient. Den här sidan dokumenterar System.Data.SqlClient.
XmlSchemaCollectionOwningSchema	Det ägande relationsschemat där schemasamlingen för den här XML-instansen finns. Använd Microsoft för ny utveckling. Data.SqlClient. Den här sidan dokumenterar System.Data.SqlClient.

Metoder

Name	Description
CreateObjRef(Type)	Skapar ett objekt som innehåller all relevant information som krävs för att generera en proxy som används för att kommunicera med ett fjärrobjekt. (Ärvd från MarshalByRefObject)
Equals(Object)	Avgör om det angivna objektet är lika med det aktuella objektet. (Ärvd från Object)
GetHashCode()	Fungerar som standard-hash-funktion. (Ärvd från Object)
GetLifetimeService()	Föråldrad. Hämtar det aktuella livslängdstjänstobjektet som styr livslängdsprincipen för den här instansen. (Ärvd från MarshalByRefObject)
GetType()	Hämtar den aktuella instansen Type . (Ärvd från Object)
InitializeLifetimeService()	Föråldrad. Hämtar ett tjänstobjekt för livslängd för att styra livslängdsprincipen för den här instansen. (Ärvd från MarshalByRefObject)
MemberwiseClone()	Skapar en ytlig kopia av den aktuella Object. (Ärvd från Object)
MemberwiseClone(Boolean)	Skapar en ytlig kopia av det aktuella MarshalByRefObject objektet. (Ärvd från MarshalByRefObject)
ResetDbType()	Återställer den typ som är associerad med den här SqlParameter. Använd Microsoft för ny utveckling. Data.SqlClient. Den här sidan dokumenterar System.Data.SqlClient.
ResetSqlDbType()	Återställer den typ som är associerad med den här SqlParameter. Använd Microsoft för ny utveckling. Data.SqlClient. Den här sidan dokumenterar System.Data.SqlClient.
ToString()	Hämtar en sträng som innehåller ParameterName. Använd Microsoft för ny utveckling. Data.SqlClient. Den här sidan dokumenterar System.Data.SqlClient.

Explicita gränssnittsimplementeringar

Name	Description
ICloneable.Clone()	En beskrivning av den här medlemmen finns i Clone(). Använd Microsoft för ny utveckling. Data.SqlClient. Den här sidan dokumenterar System.Data.SqlClient.
IDataParameter.SourceVersion	Hämtar eller ställer in som DataRowVersion ska användas vid inläsning Valueav . (Ärvd från DbParameter)
IDbDataParameter.Precision	Anger precisionen för numeriska parametrar. (Ärvd från DbParameter)
IDbDataParameter.Scale	En beskrivning av den här medlemmen finns i Scale. (Ärvd från DbParameter)

Gäller för

Se även

Feedback

Var den här sidan till hjälp?