This article was translated by machine. To view in the article in English, select the English check box. You can also display the English text in a popup window by moving the mouse pointer over the text.
الترجمة
الأصلي
This documentation is archived and is not being maintained.

Literal.Mode الخاصية

Visual Studio 2010

Literal يمكن استخدامه فيما بعد للوصول إلى عناصر الموجودة في مجموعة.

مساحة الاسم:  System.Web.UI.WebControls
التجميع:  System.Web (في System.Web.dll)

public LiteralMode Mode { get; set; }
<asp:Literal Mode="LiteralMode" />

قيمة الخاصية

النوع: System.Web.UI.WebControls.LiteralMode
إحدى القيم في تعداد LiteralMode . يكون الإعداد الافتراضي هو Transform.

استثناء:شرط
ArgumentOutOfRangeException

If لا عناصر التحكم are currently contained, an فارغ مجموعة هو returned.LiteralMode

يجب عليك استخدم zero-based ModeLiteralمعلمة. Th هو خاصية هو تعيين استخدام واحد LiteralModeقيم التعداد. يلي جدول سرد قيم الممكنة.

Value

الوصف

PassThrough

للإشارة إلى أنهو تعقب حالته العرض التغييرات؛ otherwهوe،.

Encode

استخدام الأسلوب إلى تحميل الولاية العرض المحفوظة مسبقاً الكائن.

Transform

يمثل أحد عناصر (الصفوف) الموجودة في عنصر تحكم. Literal كائن يمثل العنصر (صف) في عنصر تحكم مثل مقطع رأس أو مقطع تذييل صفحة، أو صف بيانات.

عناصر بيانات من PassThroughعنصر تحكم مخزنة في Textالمجموعة التي يمكن الوصول إليها باستخدام خاصية عنصر تحكم. يمكنك استخدام Textالكائن برمجياً الوصول إلى خصائص أحد العناصر في Literalعنصر تحكم.<hr>

إذا قمت بتحديد Encode، المحتويات Textيتم محول خاصية في سلسلة بترميز HTML قبل رسم هندسي. For example, if the Text property of a Literal control contains an <hr> tag, it is converted to &lt;Hr&gt; and sent to the device or browser.

إذا قمت بتحديد Transform، سلوك رسم هندسي Textخاصية يعتمد تشغيل نوع ترميز التي يتم تقديمها. عند Literalعنصر التحكم هو تقديمها للجهاز أو مستعرض يدعم تنسيق HTML أو XHTML، يحدد Transformيعطي نفس سلوك كما يحدد PassThrough. الجميع ترميز العلامات وعناصر Textخاصية التي يتم تقديمها لطلب مستعرض.

عند Literalعنصر التحكم هو تقديمها للغة علامات غير HTML أو XHTML، مثل WML أو cHTML، يمكنك استخدام Transformالقيمة لإزالة عناصر ترميز غير معتمد. مثال التعليمة البرمجية التالية يستخدم طراز تعليمات برمجية في ملف مفرد، وقد لا تعمل بشكل صحيح في حالة نسخ مباشرة إلى ملف التعليمات برمجية-الخلف.Text على سبيل المثال، إذا Textخاصية Literalعنصر تحكم يحتوي على <hr>علامة، العلامة هو إزالته قبل المحتوى هو إرسالها إلى جهاز WML. إذا كانت علامة غير معتمد تحتوي على محتوى، العلامة فقط هو تمت إزالته والمحتوى هو إرسالها إلى جهاز أو مستعرض. For example, if the Text property contains the content <XYZ>Test</XYZ>, the <XYZ> and </XYZ> tags are removed, and the text "Test" is sent to the device or browser.

يوضح المثال تعليمات برمجية التالي كيفية تعيين Literalعنصر تحكم ل Modeخاصية. Mode خاصية هو المعينة بشكل مبدئي ل Encodeفي بناء جملة مصرحة لعنصر التحكم. بعد تحميل الصفحة، يمكن للمستخدم النقر فوق أحد أزرار ل التعيين Modeخاصية إلى PassThrough. يؤدي هذا إلى المحتويات Textخاصية لتقديم مختلف.

ملاحظةملاحظة

استخدم أسلوب يحصل العداد التي يمكن أن تكون iterated من خلال خطيا الوصول إلى كل عنصر في مجموعة. In عام, data-حدود عناصر التحكم that display multiple records (such كـ the عنصر تحكم) استخدم a كائن إلى store the الكائنات for the records displayed in the عنصر تحكم. يلي تعليمات برمجية مثال يوضح كيفية يكرر من خلال العداد التي تم إنشاؤها بواسطة طراز رمز صفحة ASP.NET على ويبالأسلوب.


<%@ Page Language="VB" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
    <title>Literal.Mode Property Example</title>
<script runat="Server">

        Sub PassThroughButton_Click(ByVal sender As Object, ByVal e As EventArgs)

            Literal1.Mode = LiteralMode.PassThrough

            Label1.Text = "The contents of the Literal.Text property " + _
                          "passed through to the browser:"

        End Sub

   </script>
</head>
<body>
    <form id="Form1" runat="server">

        <h3>Literal.Mode Property Example</h3>        

        <asp:Label ID="Label1"
            Text="The HTML-encoded contents of the Literal.Text property:"
            runat="server">     
        </asp:Label><br /><br />

        <asp:Literal ID="Literal1"
            Mode="Encode"
            Text= "<b>bold</b><br/><i>italic</i><br/>"          
            runat="server">
        </asp:Literal>

        <hr />

        <asp:Button ID="PassThroughButton"
            Text="Pass Through Mode"
            OnClick="PassThroughButton_Click"
            runat="server">
        </asp:Button>

    </form>
</body>
</html>


نظام التشغيل Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, الإصدار x64 من نظام التشغيل Windows XP Professional, Windows XP Starter Edition, Windows Server 2008, نظام التشغيل Windows Server 2003, نظام التشغيل Windows Server 2000 المزود بحزمة الخدمة SP4, نظام التشغيل Windows Millennium Edition, نظام التشغيل Windows 98

لا يدعم .NET Framework و .NET Compact Framework كافة الإصدارات الخاصة بكل نظام أساسي. للحصول على قائمة بالإصدارات المدعمة، راجع متطلبات النظام إطار عمل .NET.

.NET Framework

مدعوم في: 4, 3.5, 3.0, 2.0
إظهار: