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.

BoundField.DataFormatString الخاصية

Visual Studio 2010

يمثل حقل التي هو dهوplayed كنص في عنصر تحكم حدود بيانات.

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

public virtual string DataFormatString { get; set; }

قيمة الخاصية

النوع: System.String
الفئة هو المستخدمة من قبل عناصر تحكم حدود بيانات (مثل و ) إلى dهوplay القيمة أحد الحقول كنص. على سبيل المثال، عنصر تحكم يعرض الكائن كعمود، بينما عنصر تحكم يعرض كصف.

لتحديد حقل لعرض في DataFormatStringكائن، قم بتعيين BoundFieldخاصية إلى اسم الحقل. يمكن أن القيمة الحقل بترميز HTML قبله هو dهوplayed بتعيين DataFormatStringخاصية إلى .

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

يمكنك يطبق سلسلة تنسيق مخصصة على قيمة حقل's بتعيين HtmlEncodeخاصية.false عند DataFormatStringهو الخاصية ، ترميز القيمة السلسلة للحقل هو المستخدمة في سلسلة تنسيق مخصص.

افتراضياً، يكون لسلسلة تنسيق هو تطبيقها على قيم الحقل فقط عند التحكم بربط البيانات هو في الوضع القراءة فقط.BoundField لتطبيق تنسيق السلسلة قيم dهوplayed مع عنصر التحكم منضم للبيانات هو في تحرير الالوضع، بتعيين ApplyFormatInEditModeخاصية إلى true.

إذا كانت القيمة الحقل هو فارغاً، يمكن dهوplay تسمية توضيحية مخصصة بواسطة تعيين خاصية. For example, in the formatting string Item Value: {0}, the field's value is substituted for the {0} placeholder when the string is displayed in the BoundField object. يمكنك إخفاء كائن في عنصر تحكم حدود بيانات بتعيين خاصية إلى .

لمنع إجراء التعديل في الوضع التحرير القيمة أحد الحقول، قم بتعيين خاصية إلى . في حدود بيانات عنصر تحكم s يدعم إدراج سجلات (مثل عنصر تحكم)، يمكنك إخفاء الكائن بتعيين خاصية إلى . This هو commonly done when you want إلى إخفاء an automatically generated المفتاح حقل في إدراج الوضع. You can يخصص the عنوان وتذييل الصفحة sections of a {0:C} كائن.

إلى عرض a تسمية توضيحية في the عنوان أو تذييل الصفحة sections, التعيين the Format أو خصائص, respectively. These بيانات-حدود عناصر التحكم do not دعم the خاصية for an individual حدود حقل. The following تعليمات برمجية مثال demonstrates how إلى استخدم a كائن إلى عرض the قيم of a حقل في a عنصر تحكم.

لإضافة بشكل حيوي الكائن لربط بيانات عنصر تحكم، إنشاء جديد الكائن، قم بتعيين خصائصه، وقم بإضافته إلى مجموعة الحقول عنصر تحكم's ربط البيانات. ثابت التصريح بكافة الحقول الخاصة بك إلى تقليل حجم حالة العرض لربط البيانات الأصلية عنصر تحكم.X The following تعليمات برمجية مثال demonstrates how إلى استخدم the الدالة الإنشائية إلى dynamically إضافة a كائن إلى a عنصر تحكم.

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

الحصول أو تعيين قيمة تشير إلى ما إذا كانت سلسلة التنسيق المحدد بواسطة تطبيق الخصائص على قيم الحقل عند ربط البيانات عنصر تحكم الذي يحتوي على كائن تم تحرير الوضع. en-US إلى يطبق the تنسيق سلسلة إلى حقل قيم في تحرير الوضع; otherwise, .

توفر الفئة حدث، والتي هو raهوed عند تغيير تحديد في عنصر التحكم lهوt بين عمليات النشر إلى الملقم.

الوصف

المثال

C أو c

يسمح لك هذا إلى توفر معالج cusإلىm لهذا حدث. بيانات-حدود عناصر التحكم (such كـ , , و ) have different عرض modes that allow the مستخدم إلى read, تحرير, أو إدراج records.

التنسيق: {0:C}

123.456 -> $123.46

التنسيق: {0:C3}

123.456 -> $123.456

D أو d

بواسطة الافتراضي, the تنسيق سلسلة specified بواسطة the خاصية هو applied إلى حقل قيم فقط when the بيانات-تحكم محدود هو في read-فقط الوضع. A كائن does not automatically إزالة the تنسيق when the حقل هو محدث في the بيانات المصدر. If you do not want the تنسيق كـ part of the القيمة stored, you will need إلى إزالة the تنسيق programmatically.

التنسيق: {0:D}

1234 -> 1234

التنسيق: {0:D6}

1234 -> 001234

E أو e

يوضح المثال تعليمات برمجية التالي كيفية تحديد عناصر في عنصر تحكم. بيانات-حدود عناصر التحكم (such كـ , , و ) have different عرض modes that allow the مستخدم إلى read, تحرير, أو إدراج records.

التنسيق: {0:E}

The following تعليمات برمجية مثال demonstrates how إلى استخدم the خاصية إلى يطبق the تنسيق سلسلة إلى حقل قيم while a عنصر تحكم هو في تحرير الوضع.

التنسيق: {0:E2}

تنسيق هو ثم برمجياً إزالته قبل القيمة هو تحديثها في مصدر البيانات.

F أو f

إذا كان العنصر هو الموجود في صندوق نص، فإن العنصر هو المحدد ورسالة هو dهوplayed تفيد اسم العنصر المحدد. بيانات-حدود عناصر التحكم (such كـ , , و ) have different عرض modes that allow the مستخدم إلى read, تحرير, أو إدراج records.

التنسيق: {0:F}

1234.567 -> 1234.57

التنسيق: {0:F3}

1234.567 -> 1234.567

G أو g

الحصول أو قم بتعيين القيمة للإشارة إلى ما إذا كان بإفراغ قيم السلسلة ("") يتم محولها تلقائياً إلى قيم فارغة عند حقل البيانات هو تحديثها في مصدر البيانات. إلى automatically تحويل فارغ سلسلة قيم إلى null قيم; otherwise, the .

التنسيق: {0:G}

-123.456 -> -123.456

التنسيق: {0:G2}

-123.456 -> -120

N أو n

في بعض الأحيان قد يقوم المستخدم بإدخال سلسلة فارغة قيمة الحقل عند إدراج سجلات أو تحديثه. بيانات-حدود عناصر التحكم (such كـ , , و ) have different عرض modes that allow the مستخدم إلى read, تحرير, أو إدراج records.

التنسيق: {0:N}

1234.567 -> 1,234.57

التنسيق: {0:N4}

1234.567 -> 1,234.5670

P أو p

استخدام خاصية لتحديد ما إذا كانت فارغة قيمة السلسلة هو تحويله تلقائياً إلى قيمة خالية عندما حقل البيانات هو تحديثها في مصدر البيانات. بيانات-حدود عناصر التحكم (such كـ , , و ) have different عرض modes that allow the مستخدم إلى read, تحرير, أو إدراج records.

التنسيق: {0:P}

1 -> 100.00%

التنسيق: {0:P1}

.5 -> 50.0%

R أو r

عن طريق الافتراضي، Singleالكائن يعرض قيم الخالية كسلاسل فارغة.Double

التنسيق: {0:R}

123456789.12345678 -> 123456789.12345678

X أو x

يوضح المثال تعليمات برمجية التالي كيفية استخدام الخاصية لتحديد سلسلة فارغة ("") قيمة الحقل تلقائياً محول إلى قيمة خالية. A كائن does not automatically إزالة the تنسيق when the حقل هو محدث في the بيانات المصدر.

التنسيق: {0:X}

الحصول أو تعيين الاسم حقل البيانات الربط إلى الكائن.

التنسيق: {0:x4}

The اسم of the بيانات حقل إلى يربط إلى the .

The قيم of the specified حقل are displayed في the سلاسل التنسيق الرقمي القياسية كائن كـ نص. You can optionally تنسيق the displayed نص بواسطة إعداد the خاصية. لمزيد من المعلومات، راجع سلاسل التنسيق الرقمي المخصص.

إذا كانت قيمة الحقل هو قيمة خالية، سلسلة فارغة ("") هو dهوplayed للقيمة بشكل افتراضي.DateTime إلى specify an بديل تسمية توضيحية, التعيين the خاصية. The following تعليمات برمجية مثال demonstrates how إلى استخدم the DateTime خاصية إلى specify which الحقل المراد عرضه في a en-US حقل عمود of a عنصر تحكم.

توفر الفئة حدث، والتي هو raهوed عند تغيير تحديد في عنصر التحكم lهوt بين عمليات النشر إلى الملقم.

الوصف

المثال

d

نمط التاريخ المختصر.

التنسيق: {0:d}

الحصول أو تعيين السلسلة التي تحدد تنسيق العرض لقيمة الحقل.

D

نمط التاريخ الطويل.

التنسيق: {0:D}

سلسلة تنسيق التي تحدد تنسيق العرض لقيمة الحقل.

f

نمط الوقت/التاريخ الكامل (وقت مختصر).

التنسيق: {0:f}

القيمة الافتراضية هو سلسلة فارغة ("")، الذي يشير إلى أنه لا يوجد تنسيق خاص هو المطبق على قيمة الحقل.

F

نمط الوقت/التاريخ الكامل (الوقت الطويل).

التنسيق: {0:F}

استخدم the خاصية إلى specify a مخصص عرض تنسيق for the قيم that are displayed في the كائن.

g

نمط الوقت/التاريخ العام (وقت مختصر).

التنسيق: {0:g}

If the خاصية ليس التعيين, the حقل's القيمة هو displayed without أي خاص تنسيق.

G

نمط الوقت/التاريخ العام (وقت طويل).

التنسيق: {0:G}

في versions of ASP.NET earlier than 3.5, you must التعيين the خاصية إلى في ترتيب إلى تنسيق حقول that are not سلسلة بيانات أنواع.

M أو m

نمط الشهر/اليوم.

التنسيق: {0:M}

Otherwهوe، تكون قيمة الحقل هو محوله إلى سلسلة بواسطة أسلوب المحول الافتراضي قبل سلسلة التنسيق التي هو المخزنة في الخصائص هو تطبيقه.

O أو o

نمط الاختيار التبادلي بين الوقت/التاريخ.

التنسيق: {0:o}

6/15/2009 1:45:30 PM -> 2009-06-15T13:45:30.0900000

R أو r

بشكل افتراضي، يتم تطبيق تنسيق السلسلة إلى قيمة الحقل فقط عند حدود البيانات التحكم الذي يحتوي على DateTimeFormatInfo.RFC1123Patternالكائن قيد القراءة فقط الوضع.

التنسيق: {0:R}

6/15/2009 1:45:30 PM -> Mon, 15 Jun 2009 20:45:30 GMT

s

نمط الوقت/ التاريخ القابل للفرز.

التنسيق: {0:s}

6/15/2009 1:45:30 PM -> 2009-06-15T13:45:30

t

نمط الوقت القصير.

التنسيق: {0:t}

إلى يطبق the تنسيق سلسلة إلى حقل قيم while في تحرير الوضع, التعيين the خاصية إلى .

T

نمط الوقت الطويل.

التنسيق: {0:T}

The تنسيق سلسلة can be أي قيمة حرفية سلسلة و usually يتضمن a عنصر نائب for the حقل's القيمة.

u

نمط الوقت والتاريخ العالمي القابل للفرز.

التنسيق: {0:u}

6/15/2009 1:45:30 PM -> 2009-06-15 20:45:30Z

U

نمط الوقت/التاريخ الكامل العالمي.

التنسيق: {0:U}

For مثال, في the تنسيق سلسلة {0}</codeInline>, the حقل's القيمة هو substituted for the {0} عنصر نائب when the سلسلة هو displayed في the كائن.

Y أو y

نمط الشهر السنة.

التنسيق: {0:Y}

The rest of the تنسيق سلسلة هو displayed كـ قيمة حرفية نص.

The قيم of the specified حقل are displayed في the سلاسل تنسيق الوقت والتاريخ القياسية كائن كـ نص. If the تنسيق سلسلة does not مُضمن a عنصر نائب, فقط the تنسيق سلسلة itself هو مُضمن في the final عرض نص (the حقل's القيمة من the بيانات المصدر ليس مُضمن). لمزيد من المعلومات، راجع سلاسل تنسيق الوقت والتاريخ مخصصة.

إذا كان العنصر النائب 0 (صفر) داخل الأقواس المتعرجة كما هو موضح في المثال السابق، قيمة الحقل يتم تحويلها إلى سلسلة بواسطة الأسلوب الافتراضي.DataFormatString


<%@ Page Language="C#" AutoEventWireup="true"  
    CodeFile="Default.aspx.cs" Inherits="_Default" %>

<!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 runat="server">
    <title></title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
        <asp:SqlDataSource ID="SqlDataSource1" runat="server" 
            ConnectionString="<%$ ConnectionStrings:AWLTConnectionString %>" 
            SelectCommand="SELECT ProductID, Name, ProductNumber, 
                ListPrice, Weight, ModifiedDate FROM SalesLT.Product">
        </asp:SqlDataSource>
        <asp:GridView ID="GridView1" runat="server" 
            AutoGenerateColumns="False" 
            DataKeyNames="ProductID" DataSourceID="SqlDataSource1">
            <Columns>
                <asp:BoundField DataField="ProductID" 
                    HeaderText="ProductID" 
                    InsertVisible="False" ReadOnly="True" 
                    SortExpression="ProductID" 
                    DataFormatString="{0:D6}" />
                <asp:BoundField DataField="Name" 
                    HeaderText="Name" 
                    SortExpression="Name" 
                    DataFormatString="{0}" />
                <asp:BoundField DataField="ProductNumber" 
                    HeaderText="ProductNumber" 
                    SortExpression="ProductNumber" 
                    DataFormatString= "#{0}" />
                <asp:BoundField DataField="ListPrice" 
                    HeaderText="ListPrice" 
                    SortExpression="ListPrice"
                    DataFormatString="{0:C}" />
                <asp:BoundField DataField="Weight" 
                    HeaderText="Weight" 
                    SortExpression="Weight" 
                    DataFormatString="{0:F3}" />
                <asp:BoundField DataField="ModifiedDate" 
                    HeaderText="ModifiedDate" 
                    SortExpression="ModifiedDate" 
                    DataFormatString="{0:d}" />
            </Columns>
        </asp:GridView>
    </div>
    </form>
</body>
</html>


يمكنك إلحاق الصفر سلسلة تحدد كيفية قيمة الحقل يجب أن تتم تهيئة.

ProductID

الاسم

For مثال, the عنصر نائب for a numeric حقل specifies that القيمة of the حقل should be محول إلى a عملة تنسيق.

تنسيق هو applied بواسطة using the أسلوب.

The رقم that follows the يسار curly brace هو part of the بناء الجملة used بواسطة that أسلوب و indicates which واحد of a series of قيم the عنصر نائب should استخدم.

Because there هو فقط واحد حقل القيمة في each خلية, the رقم that follows the يسار curly brace can فقط be التعيين إلى 0.

000680

HL Road Frame - Black, 58

#FR-R92B-58

$1,431.50

1016.040

3/11/2004

نظام التشغيل 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

التاريخ

المحفوظات

السبب

The following جدول lists the قياسي تنسيق حرف/ حروف for numeric حقول.

ملاحظات العميل.

إظهار: