FieldRenderer を使用したフィールドへのアクセス

Current version: 10.1
日本語翻訳に関する免責事項

このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。

プレゼンテーション コンポーネントでは、可能な限り、FieldRenderer Web コントロールを使用してフィールド値を出力します。たとえば、コンテキスト アイテムの Title フィールドを Web コントロールから出力するには、次のようにします。

RequestResponse
namespace Namespace.Web.UI.WebControls
{
    public class WebControlName : Sitecore.Web.UI.WebControl
    {
        protected override void DoRender(System.Web.UI.HtmlTextWriter output)
        {
            string html = Sitecore.Web.UI.WebControls.FieldRenderer.Render(
            Sitecore.Context.Item, "title");
            output.Write(html);
         }
      }
 }

また、FieldRenderer Web コントロールをレイアウトまたはサブレイアウトに追加することもできます。以下に例を示します。

<sc:FieldRenderer runat="server" ID="fieldControl" />

レイアウトまたはサブレイアウトのコード ビハインドで、コントロールのプロパティを設定します。たとえば、コンテキスト アイテムの Title フィールドをレンダリングするには、次のようにします。

RequestResponse
namespace Namespace.Web.UI
{
    public partial class SublayoutName : System.Web.UI.UserControl
    {
        protected void Page_Load(object sender, EventArgs e)
        {
            fieldControl.DataSource = Sitecore.Context.Item.Paths.FullPath;
            fieldControl.FieldName = "title";
         }
      }
}

重要

FieldRenderer Web コントロールは、すべてのフィールド タイプをサポートしているわけではありません。たとえば、このタイプを使用して、Multilist データを取得することはできません。「Checklist、Multilist、Treelist、TreelistEx フィールドへのアクセス」を参照してください。

FieldRenderer Web コントロールは、DateDatetimeImageIntegerMulti-Line TextNumberRich Text、および Single-Line Text の各フィールドで使用できます。

何かフィードバックはありますか?

この記事を改善するための提案がある場合は、