ProfileBase.Item[String] Özellik

  • Başvuru

Tanım

Ad Alanı:
System.Web.Profile
Bütünleştirilmiş Kod:
System.Web.dll

Özellik adına göre dizine alınan bir profil özellik değerini alır veya ayarlar.

public:
 virtual property System::Object ^ default[System::String ^] { System::Object ^ get(System::String ^ propertyName); void set(System::String ^ propertyName, System::Object ^ value); };
public override object this[string propertyName] { get; set; }
member this.Item(string) : obj with get, set
Default Public Overrides Property Item(propertyName As String) As Object

Parametreler

propertyName
String

Profil özelliğinin adı.

Özellik Değeri

Object

Belirtilen profil özelliğinin değeri olarak objectyazıldı.

Özel durumlar

ProviderException

Özelliğin özniteliğinin falseolduğu anonim profilde bir özellik allowAnonymous değeri ayarlama girişiminde bulunuldu.

SettingsPropertyNotFoundException

Geçerli profil için tanımlı özellik yok.

-veya-

Belirtilen profil özellik adı geçerli profilde yok.

-veya-

Belirtilen profil özelliğinin sağlayıcısı belirtilen özelliği tanımadı.

SettingsPropertyIsReadOnlyException

Salt okunur olarak işaretlenmiş bir özellik değeri ayarlama girişiminde bulunuldu.

SettingsPropertyWrongTypeException

Uyumsuz bir tür kullanılarak bir özelliğe değer atama girişiminde bulunuldu.

Örnekler

Aşağıdaki kod örneği, statik nesne GridView koleksiyonundan bir denetime özelliğini bağlayarak Name kullanıcı profilindeki Properties özelliklerin SettingsProperty adlarını listeler. Seçilen özellik değeri, koleksiyonu kullanılarak Item[] ada göre alınır. Kullanıcı profilinin özelliklerini belirten bir Web.config dosyası örneği için sınıf için ProfileBase sağlanan örne bakın.

<%@ Page Language="C#" %>
<%@ Import Namespace="System.Web.Profile" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

public void Page_Load()
{
  if (!IsPostBack)
  {
    PropertiesListBox.DataSource = ProfileBase.Properties;
    PropertiesListBox.DataBind();
  }

  if (PropertiesListBox.SelectedItem != null)
  {
    object propValue = Profile[PropertiesListBox.SelectedItem.Text];

    Type propType = propValue.GetType();

    // If the property is a value type, return ToString().

    if (propType == typeof(string) || propType.IsValueType)
    {
      ValueLabel.Visible = true;
      ValueGridView.Visible = false;
      ValueLabel.Text = propValue.ToString();
      return;
    }


    // Bind the property to a GridView.

    try
    {
      ValueGridView.DataSource = propValue;
      ValueGridView.DataBind();
      ValueGridView.Visible = true;
      ValueLabel.Visible = false; 
    }
    catch
    {
      // If the property is not bindable, return ToString().

      ValueLabel.Visible = true;
      ValueGridView.Visible = false;
      ValueLabel.Text = propValue.ToString();
    }
  }
}

</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title>Home Page</title>
</head>
<body>

<h3>View Profile properties:</h3>

<form id="form1" runat="server">
  <table border="0" cellpadding="2" cellspacing="2">
    <tr>
      <td>Property</td>
      <td>Value</td>
    </tr>
    <tr>
      <td valign="top">
        <asp:ListBox runat="server" id="PropertiesListBox" Rows="10" AutoPostBack="True" DataTextField="Name" />
      </td>
      <td valign="top">
        <asp:GridView runat="Server" id="ValueGridView" Visible="False" />
        <asp:Label runat="Server" id="ValueLabel" Visible="False" />
      </td>
    </tr>
  </table>
</form>

</body>
</html>

<%@ Page Language="VB" %>
<%@ Import Namespace="System.Web.Profile" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

Public Sub Page_Load()

  If Not IsPostBack Then
    PropertiesListBox.DataSource = ProfileBase.Properties
    PropertiesListBox.DataBind()
  End If

  If Not PropertiesListBox.SelectedItem Is Nothing Then
    Dim propValue As Object = Profile(PropertiesListBox.SelectedItem.Text)

    Dim propType As Type = propValue.GetType()

    ' If the property is a value type, return ToString().

    If propType Is GetType(String) Or propType.IsValueType Then
      ValueLabel.Visible = True
      ValueGridView.Visible = False
      ValueLabel.Text = propValue.ToString()
      Return
    End If


    ' Bind the property to a GridView.

    Try
      ValueGridView.DataSource = propValue
      ValueGridView.DataBind()
      ValueGridView.Visible = True
      ValueLabel.Visible = False 
    Catch
      ' If the property is not bindable, return ToString().

      ValueLabel.Visible = True
      ValueGridView.Visible = False
      ValueLabel.Text = propValue.ToString()
    End Try
  End If
End Sub

</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title>Home Page</title>
</head>
<body>

<h3>View Profile properties:</h3>

<form id="form1" runat="server">
  <table border="0" cellpadding="2" cellspacing="2">
    <tr>
      <td>Property</td>
      <td>Value</td>
    </tr>
    <tr>
      <td valign="top">
        <asp:ListBox runat="server" id="PropertiesListBox" Rows="10" AutoPostBack="True" DataTextField="Name" />
      </td>
      <td valign="top">
        <asp:GridView runat="Server" id="ValueGridView" Visible="False" />
        <asp:Label runat="Server" id="ValueLabel" Visible="False" />
      </td>
    </tr>
  </table>
</form>

</body>
</html>

Açıklamalar

Uygulamanızın kullanıcı profilinin özellik değerlerini ada göre almak veya ayarlamak için bu özelliği kullanabilirsiniz. Döndürülen değerler olarak object yazılır ve alındığında belirli bir nesne türü olarak yayınlanmalıdır. Profil özelliği değerlerine kesin olarak yazılan erişim için, özelliğe ada göre her sayfada bulunan özelliğin Profile bir üyesi olarak erişebilirsiniz; örneğin, Profile.CustomerAddress.

Şunlara uygulanır

Ayrıca bkz.