【ASP.NETチュートリアル-WPリファレンスマニュアル05】ASP.NET Webページ - その他ヘルパーオブジェクトリファレンスマニュアル

ASP.NET Web ページ - その他のヘルパー オブジェクト リファレンス マニュアル

ASP.NET Web ページ - サンプル オブジェクト リファレンス マニュアル

ASP.NET Web ページでは、ヘルパー (ヘルパー) は、一般的なタスクと操作を簡素化するための強力なツールです。組み込みヘルパーに加えて、特定のニーズに合わせて独自のヘルパーを作成することもできます。この記事では、サンプル コードや詳細な手順など、ASP.NET Web ページのヘルパーについて詳しく説明します。

1. Jsonオブジェクトリファレンスマニュアル

Json オブジェクトは、JSON データを操作するときに非常に役立つヘルパーの 1 つです。JSON 文字列を処理および操作するための一連のメソッドを提供します。

サンプルコード:

@{
    
    
    var json = "{ \"name\": \"John\", \"age\": 30 }";
    var jsonObject = Json.Decode(json);
    
    var name = jsonObject.name;
    var age = jsonObject.age;
    
    var newJson = Json.Encode(jsonObject);
}

<p>Name: @name</p>
<p>Age: @age</p>
<p>New JSON: @newJson</p>

例証します:

上記のサンプル コードは、Json オブジェクトを使用して JSON 文字列をデコードおよびエンコードする方法を示しています。この例では、まず JSON 文字列を動的オブジェクトにデコードしjsonObject、次にオブジェクトのプロパティにアクセスしてデータを取得します。次に、Json.EncodeメソッドjsonObjectオブジェクトを JSON 文字列に再エンコードし、ページに表示します。

2. ModelState オブジェクト リファレンス マニュアル

ModelState オブジェクトは、フォームの送信を処理するときによく使用されるヘルパーの 1 つです。これはモデルの状態を管理および検証するために使用され、エラー メッセージを処理するための一連のメソッドを提供します。

サンプルコード:

@{
    
    
    var model = new MyModel();
    var submitted = IsPost && ModelState.IsValid;
    
    if (submitted)
    {
    
    
        // 处理表单提交
    }
}

@using (Html.BeginForm())
{
    
    
    <div>
        <label for="name">Name:</label>
        <input type="text" name="name" id="name" value="@model.Name" />
        @if (submitted && !ModelState.IsValidField("name"))
        {
    
    
            <p>@ModelState.GetFieldErrors("name")[0]</p>
        }
    </div>
    
    <div>
        <label for="age">Age:</label>
        <input type="text" name="age" id="age" value="@model.Age" />
        @if (submitted && !ModelState.IsValidField("age"))
        {
    
    
            <p>@ModelState.GetFieldErrors("age")[0]</p>
        }
    </div>
    
    <input type="submit" value="Submit" />
}

例証します:

上記のサンプル コードは、ModelState オブジェクトを使用してフォームの送信と検証を処理する方法を示しています。この例では、最初にモデル オブジェクトを作成しmodel、次に POST リクエストが行われたかどうか、およびモデルの状態が有効かどうかを確認します。フォームでは、フォームを作成するHtml.BeginFormメソッドと、ModelState.IsValidField特定のフィールドの検証ステータスを確認するメソッドを使用します。フィールドの検証が失敗した場合は、ModelState.GetFieldErrorsメソッドをエラー メッセージを取得し、ページに表示します。

3. WebGrid オブジェクト リファレンス マニュアル

WebGrid オブジェクトは、ASP.NET Web ページでデータ グリッドを表示および管理するための強力なヘルパーです。並べ替え、ページネーション、カスタム列などの豊富な機能を提供します。

サンプルコード:

@{
    
    
    var grid = new WebGrid(Model);
    var columns = new[] {
    
     "Name", "Age", "Email" };
    
    var sortedColumns = grid.SortColumn != null ? new[] {
    
     grid.SortColumn } : null;
    var sortedData = grid.GetSortedColumns(columns, sortedColumns);
    
    var pagedData = sortedData.Skip((grid.PageIndex - 1) * grid.PageSize).Take(grid.PageSize);
}

<div id="grid">
    @grid.GetHtml(
        columns: grid.Columns(
            grid.Column("Name"),
            grid.Column("Age"),
            grid.Column("Email")
        ),
        tableStyle: "grid",
        headerStyle: "grid-header",
        alternatingRowStyle: "grid-alternating-row",
        selectedRowStyle: "grid-selected-row",
        rowStyle: "grid-row",
        mode: WebGridPagerModes.All,
        numericLinksCount: 5,
        firstText: "<<",
        previousText: "<",
        nextText: ">",
        lastText: ">>",
        htmlAttributes: new {
    
     id = "grid-table" }
    )
</div>

例証します:

上記のサンプル コードは、WebGrid オブジェクトを使用してデータ テーブルを表示および管理する方法を示しています。この例では、まず WebGrid オブジェクトを作成しgrid、表示する列を定義しますcolumns次に、grid.SortColumnプロパティ現在の並べ替え列とgrid.GetSortedColumnsデータを並べ替えるメソッドを決定します。次に、ページネーションSkipTake最後に、grid.GetHtmlメソッドテーブルの HTML コードを生成し、さまざまなスタイルと属性を指定します。

4. 共通オブジェクトリファレンスマニュアル:

アナリティクス オブジェクト リファレンス (Google)

ヘルパー 説明
Analytics.GetGoogleHtml(webPropertyId) 指定された ID の Google Analytics JavaScript コードをレンダリングします。
Analytics.GetStatCounterHtml(プロジェクト、セキュリティ) 指定された項目の StatCounter Analytics JavaScript コードをレンダリングします。
Analytics.GetYahooHtml(アカウント) 指定されたアカウントの Yahoo Analytics JavaScript コードをレンダリングします。

Bing オブジェクトのリファレンス

ヘルパー 説明
Bing.GetImageHtml(クエリ) 指定されたクエリに基づいて Bing 画像検索結果をレンダリングします。
Bing.GetVideoHtml(クエリ) 指定されたクエリに基づいて Bing Video の検索結果をレンダリングします。
Bing.GetNewsHtml(クエリ) 指定されたクエリに基づいて Bing ニュースの検索結果を表示します。
Bing.GetManySearchesHtml(クエリ) 指定されたクエリに基づいて、関連する検索結果を表示します。
Bing.GetSpellSuggestionsHtml(クエリ) 指定されたクエリに基づいてスペル候補の結果を表示します。

チャートオブジェクトリファレンスマニュアル

ヘルパー 説明
Chart.GetHtml() 指定された構成を使用して空のチャートをレンダリングします。
Chart.GetHtml(データ) 指定されたデータと構成を使用してチャートをレンダリングします。
Chart.GetHtml(データ、構成) 指定されたデータと構成を使用してチャートをレンダリングします。
Chart.GetImageTag() 指定された構成を使用して、空のチャートのイメージ ラベルを返します。
Chart.GetImageTag(データ) 指定されたデータと構成を使用して、チャートのイメージ ラベルを返します。
Chart.GetImageTag(データ, 構成) 指定されたデータと構成を使用して、チャートのイメージ ラベルを返します。
Chart.Write() 指定されたデータと構成を応答出力に直接書き込みます。

暗号オブジェクトリファレンスマニュアル

ヘルパー 説明
Crypto.HashPassword(パスワード) 指定されたパスワードのハッシュ値を返します。
Crypto.PasswordEquals(パスワード, ハッシュ化されたパスワード) パスワードが指定されたハッシュと一致することを検証します。
Crypto.GenerateToken() ランダムなセキュリティ トークンを生成します。

Facebook オブジェクト リファレンス マニュアル

ヘルパー 説明
Facebook.GetProfilePictureUrl(userId) 指定されたユーザーの Facebook プロフィール写真の URL を返します。
Facebook.GetFriends(ユーザーID) 指定されたユーザーの Facebook の友達のリストを返します。
Facebook.PostMessage(ユーザーID, メッセージ) 指定したユーザーの Facebook アカウントにメッセージを投稿します。
Facebook.ShareLink(userId, URL) 指定したユーザーの Facebook アカウントで指定した URL へのリンクを共有します。
Facebook.SendNotification(userId, 通知) 指定したユーザーの Facebook アカウントに通知を送信します。

FileUpload オブジェクト リファレンス マニュアル

ヘルパー 説明
FileUpload.Save(ファイル、パス) アップロードしたファイルを指定したパスに保存します。
FileUpload.SaveAs(ファイル、パス) アップロードしたファイルを指定したパスにファイルとして保存します。
FileUpload.GetFileSize(ファイル) アップロードされたファイルのサイズをバイト単位で返します。
FileUpload.GetFileExtension(ファイル) アップロードされたファイルの拡張子を返します。
FileUpload.IsValidFileExtension(ファイル, allowedExtensions) アップロードされたファイルの拡張子が許可された範囲内であることを確認してください。
FileUpload.IsValidFileSize(ファイル, maxSize) アップロードされたファイルのサイズが許容範囲内であることを確認してください。

GamerCard オブジェクト リファレンス マニュアル

ヘルパー 説明
GamerCard.GetGamertag(userId) 指定されたユーザーのゲーマータグを返します。
GamerCard.GetAvatarUrl(userId) 指定されたユーザーのゲーム アバター画像の URL を返します。
GamerCard.GetFriends(userId) 指定されたユーザーのゲームフレンドのリストを返します。
GamerCard.GetAchievements(userId) 指定されたユーザーのゲーム実績のリストを返します。
GamerCard.GetRecentGames(userId) 指定されたユーザーが最近プレイしたゲームのリストを返します。
GamerCard.SendMessage(userId, メッセージ) 指定したユーザーのゲーム アカウントにメッセージを送信します。

Gravatar オブジェクト リファレンス マニュアル

ヘルパー 説明
Gravatar.GetImageUrl(メール) 指定された電子メールに関連付けられた Gravatar アバター画像の URL を返します。
Gravatar.GetProfileUrl(メール) 指定された電子メールに関連付けられた Gravatar プロファイルの URL を返します。
Gravatar.GetDefaultImageUrl() デフォルトの Gravatar アバター画像の URL を返します。
Gravatar.GetDefaultProfileUrl() デフォルトの Gravatar 構成ファイルの URL を返します。
Gravatar.GetImageUrlWithSize(メールアドレス, サイズ) 返回指定大小的与指定电子邮件关联的 Gravatar 头像图片的 URL。

Json 对象参考手册

Helper 描述
Json.Serialize(data) 将指定对象序列化为 JSON 字符串。
Json.Deserialize(json) 将 JSON 字符串反序列化为指定类型的对象。

| Json.IsValid(json) | 验证 JSON 字符串是否有效。 |
| Json.PrettyPrint(json) | 格式化 JSON 字符串,使其更易读。 |

LinkShare 对象参考手册

Helper 描述
LinkShare.GenerateLink(url) 生成可跟踪的分享链接,用于在社交媒体和网站上共享。
LinkShare.GetSharedLinkUrl(linkId) 返回指定链接 ID 的共享链接的 URL。
LinkShare.GetSharedLinkStats(linkId) 返回指定链接 ID 的共享链接的统计数据。
LinkShare.GetSharedLinkInfo(linkId) 返回指定链接 ID 的共享链接的详细信息。

ModelState 对象参考手册

Helper 描述
ModelState.IsValid 获取一个布尔值,指示模型状态是否有效。
ModelState.AddModelError(key, errorMessage) 将指定的错误消息添加到指定键的模型状态中。
ModelState.Clear() 清除模型状态中的所有错误消息。
ModelState.Remove(key) 从模型状态中删除指定键的错误消息。

ObjectInfo 对象参考手册

Helper 描述
ObjectInfo.GetProperties(obj) 返回指定对象的所有属性信息。
ObjectInfo.GetPropertyValue(obj, propertyName) 返回指定对象的指定属性的值。
ObjectInfo.SetPropertyValue(obj, propertyName, value) 设置指定对象的指定属性的值。

Recaptcha 对象参考手册

Helper 描述
Recaptcha.ValidateResponse(response) 验证 reCAPTCHA 响应是否有效。
Recaptcha.GetHtml(siteKey) 返回用于呈现 reCAPTCHA 控件的 HTML 代码。
Recaptcha.GetScriptTag() 返回引用 reCAPTCHA JavaScript 脚本的脚本标签。

Twitter 对象参考手册

Helper 描述
Twitter.GetTweetHtml(tweetId) 返回指定 Tweet ID 的嵌入式 Tweet HTML 代码。
Twitter.GetTimelineHtml(username) 返回指定 Twitter 用户的时间线的 HTML 代码。
Twitter.GetFollowButtonHtml(username) 返回关注指定 Twitter 用户的按钮的 HTML 代码。
Twitter.GetShareButtonHtml(url) 返回分享指定 URL 的按钮的 HTML 代码。

Video 对象参考手册

Helper 描述
Video.GetEmbeddedPlayer(url) 返回指定视频 URL 的嵌入式播放器的 HTML 代码。
Video.GetThumbnailUrl(url) 返回指定视频 URL 的缩略图的 URL。

WebCache 对象参考手册

Helper 描述
WebCache.Get(key) 返回缓存中指定键的值。
WebCache.Set(key, value, expiration) 将指定键值对添加到缓存中,并指定过期时间。
WebCache.Remove(key) 从缓存中删除指定键的值。

WebGrid 对象参考手册

Helper 描述
WebGrid.GetHtml() 返回 WebGrid 控件的 HTML 代码。
WebGrid.Bind(data) 将数据绑定到 WebGrid 控件。
WebGrid.Pager(pagingInfo) 返回用于分页的 HTML 代码。
WebGrid.Column(columnName) 添加一个列到 WebGrid 控件中。
WebGrid.Sort(sortColumn, sortOrder) 设置 WebGrid 控件的排序列和排序顺序。

请注意,上述的参考手册仅提供了常见的方法和函数示例,具体实现可能会有所不同。对于更详细的参考,请参阅相关的官方文档或开发者手册。

本文介绍了 ASP.NET Web Pages 中更多帮助器的使用方法,包括 Json 对象、ModelState 对象和 WebGrid 对象。帮助器是 ASP.NET Web Pages 开发中的重要工具,可以大大简化任务和操作。通过熟练掌握这些帮助器,您可以更高效地开发 ASP.NET Web Pages 应用程序,并为用户提供出色的用户体验。

おすすめ

転載: blog.csdn.net/qq_43797491/article/details/131338033