ProfileGroupBase.GetPropertyValue メソッドとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

ProfileGroupBase.GetPropertyValue メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

グループ化されたプロファイルプロパティの値を取得します。

名前空間: System.Web.Profile
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public Function GetPropertyValue ( _
    propertyName As String _
) As Object

Visual Basic (使用法)

Dim instance As ProfileGroupBase
Dim propertyName As String
Dim returnValue As Object

returnValue = instance.GetPropertyValue(propertyName)

public Object GetPropertyValue (
    string propertyName
)

C++

public:
Object^ GetPropertyValue (
    String^ propertyName
)

public Object GetPropertyValue (
    String propertyName
)

JScript

public function GetPropertyValue (
    propertyName : String
) : Object

パラメータ

propertyName: グループ化されたプロファイルプロパティの名前。

戻り値
object として型指定されたグループ化済みプロファイルプロパティの値。

解説

ASP.NET は、ProfileBase クラスを使用して、ユーザープロファイルのクラスを作成します。ユーザープロファイルが有効にされたアプリケーションを起動すると、ASP.NET によって、ProfileBase クラスを継承する ProfileCommon 型の新しいクラスが作成されます。profile 要素 (ASP.NET 設定スキーマ) 構成セクションに定義されているそれぞれのグループとプロパティに対して、厳密に型指定されたアクセサが ProfileCommon クラスに追加されます。ProfileCommon クラスの厳密に型指定されたアクセサは、GetPropertyValue メソッドを呼び出して ProfileProvider から型指定されていない値を取得します。その際、生成されたアクセサが、取得した値を指定された型でキャストし、グループ化されたプロパティ値として返します。

GetPropertyValue メソッドを使用して、アプリケーションのユーザープロファイルに対するグループ化されたプロパティ値を、名前によって取得できます。戻り値は object として型が指定されているため、取得時に、特定のオブジェクト型としてキャストする必要があります。型を厳密に指定してプロファイルプロパティ値へアクセスするため、Profile.Address.City などの Profile プロパティのグループメンバとして、グループ化されたプロパティに名前でアクセスできます。

使用例

ASP.NET ページが、ユーザープロファイルに対して指定された、グループ化されたプロパティを読み込んだり、設定したりするコード例を次に示します。ユーザープロファイルのグループ化されたプロパティを指定する Web.config ファイルの例については、ProfileGroupBase クラスの例を参照してください。

Visual Basic

<%@ Page Language="VB" %>
<script runat="server">

Public Sub Page_Load()
  If Not IsPostBack Then
    StreetTextBox.Text          = Profile.Address.Street
    CityTextBox.Text            = Profile.Address.City
    StateTextBox.Text           = Profile.Address.State
    CountryOrRegionTextBox.Text = Profile.Address.CountryOrRegion
    ZipCodeTextBox.Text         = Profile.ZipCode
  End If
End Sub

Public Sub UpdateButton_OnClick(sender As
 Object, args As EventArgs)
  Profile.Address.Street          = StreetTextBox.Text
  Profile.Address.City            = CityTextBox.Text
  Profile.Address.State           = StateTextBox.Text
  Profile.Address.CountryOrRegion = CountryOrRegionTextBox.Text
  Profile.ZipCode                 = ZipCodeTextBox.Text
End Sub

</script>
<html>
<head>
<title>Home Page</title>
</head>
<body>
<h3>Address Information for <%=User.Identity.Name%></h3>
<form runat="server">
  <table border=1 cellpadding=2 cellspacing=2>
    <tr>
      <td>Street Address</td>
      <td><asp:Textbox id="StreetTextBox"
 runat="server" columns="30"
 /></td>
    </tr>
    <tr>
      <td>City</td>
      <td><asp:Textbox id="CityTextBox" runat="server"
 columns="20" /></td>
    </tr>
    <tr>
      <td>State</td>
      <td><asp:Textbox id="StateTextBox"
 runat="server" columns="20"
 /></td>
    </tr>
    <tr>
      <td>Zip Code</td>
      <td><asp:Textbox id="ZipCodeTextBox"
 runat="server" columns="10"
 /></td>
    </tr>
    <tr>
      <td>Country</td>
      <td><asp:Textbox id="CountryOrRegionTextBox"
 runat="server" columns="20"
 /></td>
    </tr>
  </table>
  <asp:Button id="UpdateButton" runat="server"
 OnClick="UpdateButton_OnClick" Text="Update
 Address" />
</form>

</body>
</html>

<%@ Page Language="C#" %>
<script runat="server">

public void Page_Load()
{
  if (!IsPostBack)
  {
    StreetTextBox.Text          = Profile.Address.Street;
    CityTextBox.Text            = Profile.Address.City;
    StateTextBox.Text           = Profile.Address.State;
    CountryOrRegionTextBox.Text = Profile.Address.CountryOrRegion;
    ZipCodeTextBox.Text         = Profile.ZipCode;
  }
}

public void UpdateButton_OnClick(object sender,
 EventArgs args)
{
  Profile.Address.Street          = StreetTextBox.Text;
  Profile.Address.City            = CityTextBox.Text;
  Profile.Address.State           = StateTextBox.Text;
  Profile.Address.CountryOrRegion = CountryOrRegionTextBox.Text;
  Profile.ZipCode                 = ZipCodeTextBox.Text;
}

</script>
<html>
<head>
<title>Home Page</title>
</head>
<body>
<h3>Address Information for <%=User.Identity.Name%></h3>
<form runat="server">
  <table border=1 cellpadding=2 cellspacing=2>
    <tr>
      <td>Street Address</td>
      <td><asp:Textbox id="StreetTextBox" runat="server"
 columns="30" /></td>
    </tr>
    <tr>
      <td>City</td>
      <td><asp:Textbox id="CityTextBox" runat="server"
 columns="20" /></td>
    </tr>
    <tr>
      <td>State</td>
      <td><asp:Textbox id="StateTextBox" runat="server"
 columns="20" /></td>
    </tr>
    <tr>
      <td>Zip Code</td>
      <td><asp:Textbox id="ZipCodeTextBox" runat="server"
 columns="10" /></td>
    </tr>
    <tr>
      <td>Country</td>
      <td><asp:Textbox id="CountryOrRegionTextBox" runat="server"
 columns="20" /></td>
    </tr>
  </table>
  <asp:Button id="UpdateButton" runat="server" OnClick="UpdateButton_OnClick"
 Text="Update Address" />
</form>

</body>
</html>