SqlParameter Klass
Definition
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.
public ref class SqlParameter sealed : MarshalByRefObject, ICloneable, System::Data::IDbDataParameterpublic ref class SqlParameter sealed : System::Data::Common::DbParameter, ICloneable[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[<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 ICloneablePublic NotInheritable Class SqlParameter
Inherits MarshalByRefObject
Implements ICloneable, IDbDataParameterPublic NotInheritable Class SqlParameter
Inherits DbParameter
Implements ICloneable- Arv
- Arv
- Attribut
- Implementeringar
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. |
| SqlParameter(String, Object) |
Initierar en ny instans av SqlParameter klassen som använder parameternamnet och värdet för den nya SqlParameter. |
| 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. |
| 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(String, SqlDbType, Int32, String) |
Initierar en ny instans av SqlParameter klassen som använder parameternamnet, SqlDbType, storleken och källkolumnnamnet. |
| SqlParameter(String, SqlDbType, Int32) |
Initierar en ny instans av SqlParameter klassen som använder parameternamnet, SqlDbType, och storleken. |
| SqlParameter(String, SqlDbType) |
Initierar en ny instans av SqlParameter klassen som använder parameternamnet och datatypen. |
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. |
| DbType |
Hämtar eller anger SqlDbType parametern . |
| 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. |
| 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. |
| 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. |
| LocaleId |
Hämtar eller anger språkidentifieraren som avgör konventioner och språk för en viss region. |
| Offset |
Hämtar eller anger förskjutningen till Value egenskapen. |
| ParameterName |
Hämtar eller anger namnet på SqlParameter. |
| Precision |
Hämtar eller anger det maximala antalet siffror som används för att representera Value egenskapen. |
| Scale |
Hämtar eller anger antalet decimaler som Value har lösts. |
| Size |
Hämtar eller anger den maximala storleken, i byte, på data i kolumnen. |
| 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. |
| 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. |
| SourceVersion |
Hämtar eller ställer in som DataRowVersion ska användas när du läser in Value. |
| SqlDbType |
Hämtar eller anger SqlDbType parametern . |
| SqlValue |
Hämtar eller anger värdet för parametern som en SQL-typ. |
| TypeName |
Hämtar eller anger typnamnet för en tabellvärdesparameter. |
| UdtTypeName |
Hämtar eller anger en |
| Value |
Hämtar eller anger värdet för parametern. |
| XmlSchemaCollectionDatabase |
Hämtar namnet på databasen där schemasamlingen för den här XML-instansen finns. |
| XmlSchemaCollectionName |
Hämtar namnet på schemasamlingen för den här XML-instansen. |
| XmlSchemaCollectionOwningSchema |
Det ägande relationsschemat där schemasamlingen för den här XML-instansen finns. |
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() |
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() |
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. |
| ResetSqlDbType() |
Återställer den typ som är associerad med den här SqlParameter. |
| ToString() |
Hämtar en sträng som innehåller ParameterName. |
Explicita gränssnittsimplementeringar
| Name | Description |
|---|---|
| ICloneable.Clone() |
En beskrivning av den här medlemmen finns i Clone(). |
| 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) |