Partilhar via


SessionParameter Construtores

Definição

Inicializa uma nova instância da classe SessionParameter.

Sobrecargas

Nome Description
SessionParameter()

Inicializa uma nova instância sem nome da SessionParameter classe.

SessionParameter(SessionParameter)

Inicializa uma nova instância da SessionParameter classe com os valores da instância especificados pelo original parâmetro.

SessionParameter(String, String)

Inicializa uma nova instância nomeada da SessionParameter classe, usando a cadeia de caracteres especificada para identificar a qual par de nome/valor de estado de sessão se associar.

SessionParameter(String, DbType, String)

Inicializa uma nova instância da SessionParameter classe usando o nome e o tipo especificados e associando o parâmetro ao par de nome/valor de estado de sessão especificado. Esse construtor é para tipos de banco de dados.

SessionParameter(String, TypeCode, String)

Inicializa uma nova instância nomeada e fortemente tipada da classe, usando a SessionParameter cadeia de caracteres especificada para identificar a qual par de nome/valor de estado de sessão associar.

SessionParameter()

Inicializa uma nova instância sem nome da SessionParameter classe.

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

Exemplos

O exemplo de código a seguir demonstra como criar uma instância padrão da SessionParameter classe com o SessionParameter construtor.

// In this example, the session parameter "empid" is set
// after the employee successfully logs in.
SessionParameter empid = new SessionParameter();
empid.Name = "empid";
empid.Type = TypeCode.Int32;
empid.SessionField = "empid";
' In this example, the session parameter "empid" is set
' after the employee successfully logs in.
Dim empid As New SessionParameter()
empid.Name = "empid"
empid.Type = TypeCode.Int32
empid.SessionField = "empid"

Comentários

Um SessionParameter objeto criado com o SessionParameter construtor é inicializado com valores padrão para todas as suas propriedades. A SessionField propriedade é inicializada para String.Empty. Além disso, a Name propriedade é inicializada para String.Empty, a Type propriedade é inicializada para TypeCode.Object, a Direction propriedade é inicializada para ParameterDirection.Input, e a DefaultValue propriedade é inicializada para null.

Aplica-se a

SessionParameter(SessionParameter)

Inicializa uma nova instância da SessionParameter classe com os valores da instância especificados pelo original parâmetro.

protected:
 SessionParameter(System::Web::UI::WebControls::SessionParameter ^ original);
protected SessionParameter(System.Web.UI.WebControls.SessionParameter original);
new System.Web.UI.WebControls.SessionParameter : System.Web.UI.WebControls.SessionParameter -> System.Web.UI.WebControls.SessionParameter
Protected Sub New (original As SessionParameter)

Parâmetros

original
SessionParameter

Um SessionParameter do qual a instância atual é inicializada.

Comentários

O SessionParameter(SessionParameter) construtor é um Protected construtor de cópia usado para clonar uma SessionParameter instância. Os valores do SessionParameter objeto, incluindo o SessionField, Namee Type as propriedades, são todos transferidos para a nova instância.

Confira também

Aplica-se a

SessionParameter(String, String)

Inicializa uma nova instância nomeada da SessionParameter classe, usando a cadeia de caracteres especificada para identificar a qual par de nome/valor de estado de sessão se associar.

public:
 SessionParameter(System::String ^ name, System::String ^ sessionField);
public SessionParameter(string name, string sessionField);
new System.Web.UI.WebControls.SessionParameter : string * string -> System.Web.UI.WebControls.SessionParameter
Public Sub New (name As String, sessionField As String)

Parâmetros

name
String

O nome do parâmetro.

sessionField
String

O nome do HttpSessionState par nome/valor ao qual o objeto de parâmetro está associado. O padrão é Empty.

Comentários

As Type propriedades e as Direction propriedades são inicializadas com valores padrão.

Confira também

Aplica-se a

SessionParameter(String, DbType, String)

Inicializa uma nova instância da SessionParameter classe usando o nome e o tipo especificados e associando o parâmetro ao par de nome/valor de estado de sessão especificado. Esse construtor é para tipos de banco de dados.

public:
 SessionParameter(System::String ^ name, System::Data::DbType dbType, System::String ^ sessionField);
public SessionParameter(string name, System.Data.DbType dbType, string sessionField);
new System.Web.UI.WebControls.SessionParameter : string * System.Data.DbType * string -> System.Web.UI.WebControls.SessionParameter
Public Sub New (name As String, dbType As DbType, sessionField As String)

Parâmetros

name
String

O nome do parâmetro.

dbType
DbType

O tipo de banco de dados que o parâmetro representa.

sessionField
String

O nome do HttpSessionState par nome/valor ao qual o objeto de parâmetro está associado. O padrão é Empty.

Comentários

As Direction propriedades e as ConvertEmptyStringToNull propriedades são inicializadas com valores padrão.

Aplica-se a

SessionParameter(String, TypeCode, String)

Inicializa uma nova instância nomeada e fortemente tipada da classe, usando a SessionParameter cadeia de caracteres especificada para identificar a qual par de nome/valor de estado de sessão associar.

public:
 SessionParameter(System::String ^ name, TypeCode type, System::String ^ sessionField);
public SessionParameter(string name, TypeCode type, string sessionField);
new System.Web.UI.WebControls.SessionParameter : string * TypeCode * string -> System.Web.UI.WebControls.SessionParameter
Public Sub New (name As String, type As TypeCode, sessionField As String)

Parâmetros

name
String

O nome do parâmetro.

type
TypeCode

O tipo que o parâmetro representa. O padrão é Object.

sessionField
String

O nome do HttpSessionState par nome/valor ao qual o objeto de parâmetro está associado. O padrão é Empty.

Exemplos

O exemplo de código a seguir demonstra como usar o SessionParameter construtor para criar um SessionParameter objeto e usá-lo com um SqlDataSource controle para exibir dados em um DataGrid controle.

<%@ Page language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">
private void Page_Load(object sender, System.EventArgs e)
{
    SqlDataSource OdbcToSql = new SqlDataSource();

    // Connect to SQL Server using an ODBC DSN.
    OdbcToSql.ProviderName= "System.Data.Odbc";
    OdbcToSql.ConnectionString = "dsn=MyOdbcDsn;";

    // Use an ODBC parameterized query syntax.
    OdbcToSql.SelectCommand = "SELECT EmployeeID FROM Employees " +
                              " WHERE Country = ? AND ReportsTo = ?";

    // The country parameter has no default value, so be sure to set
    // a Session variable named "country" to "UK" or "USA".
    SessionParameter country =
        new SessionParameter("country",TypeCode.String,"country");

    SessionParameter reportsTo =
        new SessionParameter("report",TypeCode.Int32,"report");
    reportsTo.DefaultValue = "2";

    OdbcToSql.SelectParameters.Add(country);
    OdbcToSql.SelectParameters.Add(reportsTo);

    // Add the DataSourceControl to the page's Controls collection.
    Page.Controls.Add(OdbcToSql);

    DataGrid1.DataSource = OdbcToSql;
    DataGrid1.DataBind();
}

</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
    <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
        <form id="Form1" method="post" runat="server">
            <asp:DataGrid
                id="DataGrid1"
                style="Z-INDEX: 101; LEFT: 56px; POSITION: absolute; TOP: 56px"
                runat="server" />
        </form>
    </body>
</html>
<%@ Page language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">
Private Sub Page_Load(sender As Object, e As EventArgs)

    Dim OdbcToSql As New SqlDataSource()

    ' Connect to SQL Server using an ODBC DSN.
    OdbcToSql.ProviderName= "System.Data.Odbc"
    OdbcToSql.ConnectionString = "dsn=MyOdbcDsn;"

    ' Use an ODBC parameterized query syntax.
    OdbcToSql.SelectCommand = "SELECT EmployeeID FROM Employees " & _
                              " WHERE Country = ? AND ReportsTo = ?"

    ' The country parameter has no default value, so be sure to set
    ' a Session variable named "country" to "UK" or "USA".
    Dim country As SessionParameter
    country = New SessionParameter("country",TypeCode.String,"country")

    Dim reportsTo As SessionParameter
    reportsTo = New SessionParameter("report",TypeCode.Int32,"report")
    reportsTo.DefaultValue = "2"

    OdbcToSql.SelectParameters.Add(country)
    OdbcToSql.SelectParameters.Add(reportsTo)

    ' Add the DataSourceControl to the page's Controls collection.
    Page.Controls.Add(OdbcToSql)

    DataGrid1.DataSource = OdbcToSql
    DataGrid1.DataBind()

End Sub ' Page_Load

</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="Form1" method="post" runat="server">
      <asp:DataGrid
          id="DataGrid1"
          style="Z-INDEX: 101; LEFT: 56px; POSITION: absolute; TOP: 56px"
          runat="server" />
    </form>
  </body>
</html>

Comentários

As Direction propriedades e as ConvertEmptyStringToNull propriedades são inicializadas com valores padrão.

Confira também

Aplica-se a