ControlAdapter.Browser プロパティ

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

ControlAdapter.Browser プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

現在の HTTP 要求の作成元であるクライアントのブラウザ機能への参照を取得します。

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

Visual Basic (宣言)

Protected ReadOnly Property
 Browser As HttpBrowserCapabilities

Visual Basic (使用法)

Dim value As HttpBrowserCapabilities

value = Me.Browser

C#

protected HttpBrowserCapabilities Browser { get;
 }

C++

protected:
property HttpBrowserCapabilities^ Browser {
    HttpBrowserCapabilities^ get ();
}

J#

/** @property */
protected HttpBrowserCapabilities get_Browser ()

JScript

protected function get Browser
 () : HttpBrowserCapabilities

プロパティ値
クライアントのブラウザとマークアップ機能を指定する HttpBrowserCapabilities。

解説

ControlAdapter オブジェクトは、Browser プロパティによって返される HttpBrowserCapabilities オブジェクトから、クライアントのブラウザ機能を判断します。これにより、ControlAdapter オブジェクトは、ブラウザ固有のマークアップを表示するか、Control の動作を変更できます。

使用例

Browser プロパティを使用して要求元のブラウザの詳細にアクセスするコード例を次に示します。この例では、ブラウザが JavaScript と互換性があるかどうかをチェックし、互換性がある場合は、開発者がカスタマイズされた出力を表示できるようにしています。

Visual Basic

Imports System
Imports System.Web.UI
Imports System.Web.UI.Adapters

Public Class CustomControlAdapter
    Inherits ControlAdapter

    Protected Overrides Sub
 Render(ByVal writer As HtmlTextWriter)

        ' Access Browser details through the Browser property.
        Dim jScriptVersion As Version = Browser.jScriptVersion

        ' Test if the browser supports Javascript.
        If Not (jScriptVersion Is
 Nothing) Then
            ' Render JavaScript-aware markup.
        Else
            ' Render scriptless markup.
        End If

    End Sub 'Render 

End Class 'CustomControlAdapter

C#

using System;
using System.Web.UI;
using System.Web.UI.Adapters;

public class CustomControlAdapter : ControlAdapter
{
    protected override void Render( HtmlTextWriter
 writer )
    {
        // Access Browser details through the Browser property.
        Version jScriptVersion = Browser.JScriptVersion;

        // Test if the browser supports Javascript.
        if (jScriptVersion != null)
        {
            // Render JavaScript-aware markup.
        }
        else
        {
            // Render scriptless markup.
        }
    }
}

C++

#using <System.Web.dll>
#using <System.dll>

using namespace System;
using namespace System::Web::UI;
using namespace System::Web::UI::Adapters;

public ref class CustomControlAdapter: public
 ControlAdapter
{
protected:
   virtual void Render( HtmlTextWriter^ writer ) override
   {
      // Access Browser details through the Browser property.
      Version^ jScriptVersion = Browser->JScriptVersion;
      
      // Test if the browser supports Javascript.
      if ( jScriptVersion != nullptr )
      {
         // Render JavaScript-aware markup.
      }
      else
      {
         // Render scriptless markup.
      }
   }
};

J#

package BrowserProperty; 

import System.*;
import System.Web.UI.*;
import System.Web.UI.Adapters.*;

public class CustomControlAdapter extends ControlAdapter
{
    public void Render(HtmlTextWriter writer)
    {
        // Access Browser details through the base control.
        int ClientVersion = System.Convert.ToInt32(super.get_Browser().
            get_Version());
        if (ClientVersion > 1) {
            // Render output appropriate to these versions.
        }
    } //Render
} //CustomControlAdapter 

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
ControlAdapter クラス
ControlAdapter メンバ
System.Web.UI.Adapters 名前空間
Control クラス
System.Web.HttpBrowserCapabilities
System.Web.Configuration.HttpCapabilitiesBase