【Tutoriel ASP.NET-Manuel de référence WP 05】Pages Web ASP.NET - Manuel de référence de l'objet d'assistance supplémentaire

Pages Web ASP.NET - Manuel de référence des objets d'assistance supplémentaires

Pages Web ASP.NET - Manuel de référence des exemples d'objets

Dans les pages Web ASP.NET, helper (Helpers) est un outil puissant pour simplifier les tâches et opérations courantes. En plus des assistants intégrés, nous pouvons également créer nos propres assistants pour répondre à des besoins spécifiques. Cet article se penche sur d'autres assistants dans les pages Web ASP.NET, y compris un exemple de code et des instructions détaillées.

1. Manuel de référence des objets Json

L'objet Json est l'un des assistants très utiles lorsque vous travaillez avec des données JSON. Il fournit un ensemble de méthodes pour traiter et manipuler les chaînes JSON.

Exemple de code :

@{
    
    
    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>

illustrer:

L'exemple de code ci-dessus montre comment décoder et encoder des chaînes JSON à l'aide de l'objet Json. Dans l'exemple, nous décodons d'abord une chaîne JSON en un objet dynamique jsonObject, puis nous obtenons les données en accédant aux propriétés de l'objet. Ensuite, nous utilisons Json.Encodela méthode pour jsonObjectré-encoder l'objet dans une chaîne JSON et l'afficher sur la page.

2. Manuel de référence de l'objet ModelState

L'objet ModelState est l'un des assistants couramment utilisés lorsqu'il s'agit de soumettre des formulaires. Il est utilisé pour gérer et valider l'état du modèle et fournit un ensemble de méthodes pour gérer les messages d'erreur.

Exemple de code :

@{
    
    
    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" />
}

illustrer:

L'exemple de code ci-dessus montre comment utiliser l'objet ModelState pour gérer la soumission et la validation du formulaire. Dans l'exemple, nous créons d'abord un objet modèle model, puis vérifions si une requête POST a été effectuée et si l'état du modèle est valide. Dans le formulaire, nous utilisons Html.BeginFormla méthode pour créer un formulaire et ModelState.IsValidFieldla méthode pour vérifier l'état de validation d'un champ spécifique. Si la validation du champ échoue, nous utilisons ModelState.GetFieldErrorsla méthode pour obtenir le message d'erreur et l'afficher sur la page.

3. Manuel de référence de l'objet WebGrid

L'objet WebGrid est une aide puissante pour afficher et gérer les grilles de données dans les pages Web ASP.NET. Il offre des fonctionnalités riches, notamment le tri, la pagination et les colonnes personnalisées.

Exemple de code :

@{
    
    
    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>

illustrer:

L'exemple de code ci-dessus montre comment utiliser l'objet WebGrid pour afficher et gérer des tables de données. Dans l'exemple, nous créons d'abord un objet WebGrid gridet définissons les colonnes à afficher columns. Nous utilisons ensuite grid.SortColumnla propriété pour déterminer la colonne de tri actuelle et grid.GetSortedColumnsla méthode pour trier les données. Ensuite, nous utilisons les méthodes LINQ Skipet Takepour la pagination. Enfin, nous utilisons grid.GetHtmlla méthode pour générer le code HTML du tableau et spécifier divers styles et attributs.

4. Manuel de référence des objets communs :

Référence d'objet d'analyse (Google)

Assistant	décrire
Analytics.GetGoogleHtml(webPropertyId)	Rend le code JavaScript Google Analytics pour l'ID spécifié.
Analytics.GetStatCounterHtml(projet, sécurité)	Rend le code JavaScript StatCounter Analytics pour l'élément spécifié.
Analytics.GetYahooHtml(compte)	Rend le code JavaScript Yahoo Analytics pour le compte spécifié.

Référence des objets Bing

Assistant	décrire
Bing.GetImageHtml (requête)	Rend les résultats de la recherche d'images Bing en fonction de la requête spécifiée.
Bing.GetVideoHtml (requête)	Restitue les résultats de la recherche Bing Video en fonction de la requête spécifiée.
Bing.GetNewsHtml (requête)	Rend les résultats de la recherche Bing News en fonction de la requête spécifiée.
Bing.GetRelatedSearchesHtml (requête)	Rend les résultats de recherche pertinents en fonction de la requête spécifiée.
Bing.GetSpellSuggestionsHtml (requête)	Rend les résultats des suggestions orthographiques en fonction de la requête spécifiée.

Manuel de référence des objets graphiques

Assistant	décrire
Graphique.GetHtml()	Restitue un graphique vide à l'aide de la configuration spécifiée.
Graphique. GetHtml (données)	Affiche un graphique à l'aide des données et de la configuration spécifiées.
Chart.GetHtml(données, configuration)	Affiche un graphique à l'aide des données et de la configuration spécifiées.
Graphique.GetImageTag()	Renvoie l'étiquette d'image d'un graphique vide à l'aide de la configuration spécifiée.
Graphique. GetImageTag (données)	Renvoie l'étiquette d'image du graphique à l'aide des données et de la configuration spécifiées.
Chart.GetImageTag(données, configuration)	Renvoie l'étiquette d'image du graphique à l'aide des données et de la configuration spécifiées.
Graphique.Write()	Écrivez directement dans la sortie de réponse avec les données et la configuration spécifiées.

Manuel de référence des objets cryptographiques

Assistant	décrire
Crypto.HashPassword(mot de passe)	Renvoie la valeur de hachage du mot de passe spécifié.
Crypto.PasswordEquals(mot de passe, mot de passe haché)	Vérifie que le mot de passe correspond au hachage spécifié.
Crypto.GenerateToken()	Générez un jeton de sécurité aléatoire.

Manuel de référence des objets Facebook

Assistant	décrire
Facebook.GetProfilePictureUrl(userId)	Renvoie l'URL de la photo de profil Facebook de l'utilisateur spécifié.
Facebook.GetFriends(userId)	Renvoie une liste d'amis Facebook pour l'utilisateur spécifié.
Facebook.PostMessage (ID utilisateur, message)	Publiez un message sur le compte Facebook de l'utilisateur spécifié.
Facebook.ShareLink (ID utilisateur, URL)	Partager un lien vers l'URL spécifiée sur le compte Facebook de l'utilisateur spécifié.
Facebook.SendNotification (ID utilisateur, notification)	Envoyer une notification au compte Facebook de l'utilisateur spécifié.

Manuel de référence de l'objet FileUpload

Assistant	décrire
FileUpload.Save(fichier, chemin)	Enregistrez le fichier téléchargé dans le chemin spécifié.
FileUpload.SaveAs(fichier, chemin)	Enregistrez le fichier téléchargé en tant que fichier au chemin spécifié.
FileUpload.GetFileSize(fichier)	Renvoie la taille du fichier téléchargé en octets.
FileUpload.GetFileExtension(fichier)	Renvoie l'extension du fichier téléchargé.
FileUpload.IsValidFileExtension(fichier, extensions autorisées)	Vérifiez que l'extension du fichier téléchargé se situe dans la plage autorisée.
FileUpload.IsValidFileSize(fichier, maxSize)	Vérifiez que la taille du fichier téléchargé se situe dans la plage autorisée.

Manuel de référence de l'objet GamerCard

Assistant	décrire
GamerCard.GetGamertag(userId)	Renvoie le Gamertag pour l'utilisateur spécifié.
GamerCard.GetAvatarUrl (ID utilisateur)	Renvoie l'URL de l'image de l'avatar du jeu pour l'utilisateur spécifié.
GamerCard.GetFriends (ID utilisateur)	Renvoie la liste des amis du jeu de l'utilisateur spécifié.
GamerCard.GetAchievements(userId)	Renvoie une liste des réalisations de jeu pour l'utilisateur spécifié.
GamerCard.GetRecentGames (ID utilisateur)	Renvoie une liste des jeux récemment joués par l'utilisateur spécifié.
GamerCard.SendMessage (ID utilisateur, message)	Envoie un message au compte de jeu de l'utilisateur spécifié.

Manuel de référence des objets Gravatar

Assistant	décrire
Gravatar.GetImageUrl (courriel)	Renvoie l'URL de l'image de l'avatar Gravatar associée à l'e-mail spécifié.
Gravatar.GetProfileUrl (courriel)	Renvoie l'URL du profil Gravatar associé à l'e-mail spécifié.
Gravatar.GetDefaultImageUrl()	Renvoie l'URL de l'image d'avatar Gravatar par défaut.
Gravatar.GetDefaultProfileUrl()	Renvoie l'URL du fichier de configuration Gravatar par défaut.
Gravatar.GetImageUrlWithSize (e-mail, taille)	返回指定大小的与指定电子邮件关联的 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 应用程序，并为用户提供出色的用户体验。