SqlDataSource Konstruktorer

Definition

Namnområde:
System.Web.UI.WebControls
Sammansättning:
System.Web.dll

Initierar en ny instans av SqlDataSource klassen.

Överlagringar

Name Description
SqlDataSource()

Initierar en ny instans av SqlDataSource klassen.
SqlDataSource(String, String)

Initierar en ny instans av klassen SqlDataSource med det angivna kommandot reťazec pripojenia och Select.
SqlDataSource(String, String, String)

Initierar en ny instans av klassen SqlDataSource med det angivna kommandot reťazec pripojenia och Select.

SqlDataSource()

Initierar en ny instans av SqlDataSource klassen.

public:
 SqlDataSource();
public SqlDataSource();
Public Sub New ()

Se även

Gäller för

SqlDataSource(String, String)

Initierar en ny instans av klassen SqlDataSource med det angivna kommandot reťazec pripojenia och Select.

public:
 SqlDataSource(System::String ^ connectionString, System::String ^ selectCommand);
public SqlDataSource(string connectionString, string selectCommand);
new System.Web.UI.WebControls.SqlDataSource : string * string -> System.Web.UI.WebControls.SqlDataSource
Public Sub New (connectionString As String, selectCommand As String)

Parametrar

connectionString
String

Den reťazec pripojenia som används för att ansluta till den underliggande databasen.

selectCommand
String

SQL-frågan som används för att hämta data från den underliggande databasen. Om SQL-frågan är en parameteriserad SQL-sträng kan du behöva lägga Parameter till objekt i SelectParameters samlingen.

Exempel

I följande kodexempel visas hur du skapar en SqlDataSource kontroll med konstruktorn SqlDataSource . Exemplet är ovanligt eftersom SqlDataSource kontrollen inte används på en webbformulärsida, utan i implementeringen av ett mellannivåobjekt som ett enkelt sätt för ett affärsobjekt att interagera med en databas. I exemplet används en reťazec pripojenia som lagras i filen Web.config.

Det här kodexemplet är en del av ett större exempel för ObjectDataSource klassen.

// Returns a collection of NorthwindEmployee objects.
public static ICollection GetAllEmployees () {
  ArrayList al = new ArrayList();

  ConnectionStringSettings cts = ConfigurationManager.ConnectionStrings["NorthwindConnection"];

  SqlDataSource sds
    = new SqlDataSource(cts.ConnectionString, "SELECT EmployeeID FROM Employees");

  try {

    IEnumerable IDs = sds.Select(DataSourceSelectArguments.Empty);

    // Iterate through the Enumeration and create a
    // NorthwindEmployee object for each ID.
    foreach (DataRowView row in IDs) {
      string id = row["EmployeeID"].ToString();
      NorthwindEmployee nwe = new NorthwindEmployee(id);
      // Add the NorthwindEmployee object to the collection.
      al.Add(nwe);
    }
  }
  finally {
    // If anything strange happens, clean up.
    sds.Dispose();
  }

  return al;
}

' Returns a collection of NorthwindEmployee objects.
Public Shared Function GetAllEmployees() As ICollection
   Dim al As New ArrayList()

   Dim cts As ConnectionStringSettings = ConfigurationManager.ConnectionStrings("NorthwindConnection")
   Dim sds As New SqlDataSource(cts.ConnectionString, "SELECT EmployeeID FROM Employees")
   Try
      Dim IDs As IEnumerable = sds.Select(DataSourceSelectArguments.Empty)

      ' Iterate through the Enumeration and create a
      ' NorthwindEmployee object for each ID.
      For Each row As DataRowView In IDs
         Dim id As String = row("EmployeeID").ToString()
         Dim nwe As New NorthwindEmployee(id)
         ' Add the NorthwindEmployee object to the collection.
         al.Add(nwe)
      Next
   Finally
      ' If anything strange happens, clean up.
      sds.Dispose()
   End Try

   Return al
End Function 'GetAllEmployees

Kommentarer

Eftersom olika databasprodukter använder olika sorter av SQL beror syntaxen för selectCommand på den aktuella ADO.NET providern som används, vilket identifieras av egenskapen ProviderName. Om SQL-strängen är en parameteriserad fråga eller ett kommando beror platshållaren för parametern också på vilken ADO.NET-provider som används. Om providern till exempel är System.Data.SqlClient, som är standardprovidern för SqlDataSource klassen, är '@parameterName'parameterns platshållare . Men om providern är inställd på System.Data.Odbc eller System.Data.OleDbär '?'platshållaren för parametern . Mer information om parameteriserade SQL-frågor och -kommandon finns i Använda parametrar med SqlDataSource-kontrollen.

Värdet SelectCommand kan vara en SQL-sträng eller namnet på en lagrad procedur, om datakällan stöder lagrade procedurer.

Se även

Gäller för

SqlDataSource(String, String, String)

Initierar en ny instans av klassen SqlDataSource med det angivna kommandot reťazec pripojenia och Select.

public:
 SqlDataSource(System::String ^ providerName, System::String ^ connectionString, System::String ^ selectCommand);
public SqlDataSource(string providerName, string connectionString, string selectCommand);
new System.Web.UI.WebControls.SqlDataSource : string * string * string -> System.Web.UI.WebControls.SqlDataSource
Public Sub New (providerName As String, connectionString As String, selectCommand As String)

Parametrar

providerName
String

Namnet på den dataprovider som SqlDataSource används. Om ingen provider har angetts använder SqlDataSource som standard ADO.NET-providern för Microsoft SQL Server.

connectionString
String

Den reťazec pripojenia som används för att ansluta till den underliggande databasen.

selectCommand
String

SQL-frågan som används för att hämta data från den underliggande databasen. Om SQL-frågan är en parameteriserad SQL-sträng kan du behöva lägga Parameter till objekt i SelectParameters samlingen.

Kommentarer

Eftersom olika databasprodukter använder olika sorter av SQL beror syntaxen för selectCommand på den aktuella ADO.NET-providern som används, vilket identifieras av parametern providerName. Om SQL-strängen är en parameteriserad fråga eller ett kommando beror platshållaren för parametern också på vilken ADO.NET-provider som används. Om providern till exempel är System.Data.SqlClient, som är standardprovidern för SqlDataSource klassen, är '@parameterName'parameterns platshållare . Men om providern är inställd på System.Data.Odbc eller System.Data.OleDbär '?'platshållaren för parametern . Mer information om parameteriserade SQL-frågor och -kommandon finns i Använda parametrar med SqlDataSource-kontrollen.

Egenskapen SelectCommand kan vara en SQL-sträng eller namnet på en lagrad procedur, om datakällan stöder lagrade procedurer.

Se även

Gäller för