این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

Class Format

یک قالب‌کننده برای خروجی یک سند XML، با سه قالب از پیش تعریف‌شده که می‌توانند بیشتر سفارشی شوند.

// Log an XML document with specified formatting options.
var xml = '<root><a><b>Text!</b><b>More text!</b></a></root>';
var document = XmlService.parse(xml);
var output = XmlService.getCompactFormat()
    .setLineSeparator('\n')
    .setEncoding('UTF-8')
    .setIndent('   ')
    .format(document);
Logger.log(output);

مواد و روش ها

روش	نوع برگشت	توضیح مختصر
`format(document)`	`String`	`Document` داده شده را به عنوان یک رشته فرمت شده خروجی می دهد.
`format(element)`	`String`	گره `Element` داده شده را به عنوان یک رشته فرمت شده خروجی می دهد.
`setEncoding(encoding)`	`Format`	رمزگذاری کاراکتری را که قالب‌کننده باید استفاده کند را تنظیم می‌کند.
`setIndent(indent)`	`Format`	رشته مورد استفاده برای تورفتگی گره های فرزند نسبت به والدینشان را تنظیم می کند.
`setLineSeparator(separator)`	`Format`	رشته را طوری تنظیم می‌کند که هر زمان که فرمت‌کننده معمولاً یک خط شکسته را وارد می‌کند، درج شود.
`setOmitDeclaration(omitDeclaration)`	`Format`	تنظیم می‌کند که آیا قالب‌کننده باید اعلان XML را حذف کند، مانند `<?xml version="1.0" encoding="UTF-8"?>` .
`setOmitEncoding(omitEncoding)`	`Format`	تنظیم می‌کند که آیا قالب‌کننده باید کدگذاری را در اعلان XML حذف کند، مانند قسمت رمزگذاری در `<?xml version="1.0" encoding="UTF-8"?>` .

مستندات دقیق

`format(document)`

Document داده شده را به عنوان یک رشته فرمت شده خروجی می دهد.

مولفه های

نام	تایپ کنید	شرح
`document`	`Document`	سند برای قالب بندی

برگشت

String - سند فرمت شده

`format(element)`

گره Element داده شده را به عنوان یک رشته فرمت شده خروجی می دهد.

مولفه های

نام	تایپ کنید	شرح
`element`	`Element`	عنصر برای قالب بندی

برگشت

String - عنصر قالب بندی شده

`setEncoding(encoding)`

رمزگذاری کاراکتری را که قالب‌کننده باید استفاده کند را تنظیم می‌کند. آرگومان encoding باید یک رمزگذاری XML پذیرفته شده مانند ISO-8859-1 ، US-ASCII ، UTF-8 ، یا UTF-16 باشد.

// Log an XML document with encoding that does not support certain special characters.
var xml = '<root><a><b>ಠ‿ಠ</b><b>ಠ‿ಠ</b></a></root>';
var document = XmlService.parse(xml);
var output = XmlService.getRawFormat()
    .setEncoding('ISO-8859-1')
    .format(document);
Logger.log(output);

مولفه های

نام	تایپ کنید	شرح
`encoding`	`String`	رمزگذاری برای استفاده

برگشت

Format - شکل دهنده، برای زنجیر کردن

`setIndent(indent)`

رشته مورد استفاده برای تورفتگی گره های فرزند نسبت به والدینشان را تنظیم می کند. تنظیم تورفتگی به غیر از null باعث می شود که فرمت کننده پس از هر گره یک خط شکسته وارد کند.

// Log an XML document with each child node indented four spaces.
var xml = '<root><a><b>Text!</b><b>More text!</b></a></root>';
var document = XmlService.parse(xml);
var output = XmlService.getCompactFormat()
    .setIndent('    ')
    .format(document);
Logger.log(output);

مولفه های

نام	تایپ کنید	شرح
`indent`	`String`	تورفتگی برای استفاده

برگشت

Format - شکل دهنده، برای زنجیر کردن

`setLineSeparator(separator)`

رشته را طوری تنظیم می‌کند که هر زمان که فرمت‌کننده معمولاً یک خط شکسته را وارد می‌کند، درج شود. سه قالب‌کننده از پیش تعریف‌شده دارای شرایط متفاوتی هستند که تحت آن یک شکست خط وارد می‌کنند. جداکننده خط پیش‌فرض \r\n است.

// Log an XML document with several spaces and a pipe character in place of line breaks.
var xml = '<root><a><b>Text!</b><b>More text!</b></a></root>';
var document = XmlService.parse(xml);
var output = XmlService.getRawFormat()
    .setLineSeparator(' | ')
    .format(document);
Logger.log(output);

مولفه های

نام	تایپ کنید	شرح
`separator`	`String`	جداکننده برای استفاده

برگشت

Format - شکل دهنده، برای زنجیر کردن

`setOmitDeclaration(omitDeclaration)`

تنظیم می‌کند که آیا قالب‌کننده باید اعلان XML را حذف کند، مانند <?xml version="1.0" encoding="UTF-8"?> .

مولفه های

نام	تایپ کنید	شرح
`omitDeclaration`	`Boolean`	`true` برای حذف اعلان XML. `false` برای گنجاندن آن

برگشت

Format - شکل دهنده، برای زنجیر کردن

`setOmitEncoding(omitEncoding)`

تنظیم می‌کند که آیا قالب‌کننده باید کدگذاری را در اعلان XML حذف کند، مانند قسمت رمزگذاری در <?xml version="1.0" encoding="UTF-8"?> .

مولفه های

نام	تایپ کنید	شرح
`omitEncoding`	`Boolean`	`true` تا رمزگذاری در اعلان XML حذف شود. `false` برای گنجاندن آن

برگشت

Format - شکل دهنده، برای زنجیر کردن