Class TextOutput

تحويل النص

كائن Textإخراج يمكن عرضه من نص برمجي.

لأسباب تتعلق بالأمان، لا يمكن للنصوص البرمجية عرض محتوى نصي مباشرةً في المتصفح. وبدلاً من ذلك، تتم إعادة توجيه المتصفّح إلى googleusercontent.com، والذي سيعرضه بدون أي عملية تطهير أو تلاعب إضافية.

يمكنك عرض محتوى نصي كما يلي:

function doGet() {
  return ContentService.createTextOutput("hello world!");
}
هناك أيضًا طرق لعرض JSON وRSS وXML كمخرجات نصية. يمكنك الاطّلاع على الطرق المقابلة لها على ContentService.

الطُرق

الطريقةنوع الإرجاعوصف قصير
append(addedContent)TextOutputلإلحاق محتوى جديد بالمحتوى الذي سيتم عرضه
clear()TextOutputيؤدي إلى محو المحتوى الحالي.
downloadAsFile(filename)TextOutputيتم استخدام هذا الإعداد لإبلاغ المتصفّحات بتنزيل المحتوى بدلاً من تنزيله.
getContent()Stringيحصل على المحتوى الذي سيتم عرضه.
getFileName()Stringعرض اسم الملف لتنزيل هذا الملف بتنسيق ، أو تركه فارغًا إذا كان يجب عرضه بدلاً من تنزيله.
getMimeType()MimeTypeحدِّد نوع بروتوكول MIME لهذا المحتوى.
setContent(content)TextOutputضبط المحتوى الذي سيتم عرضه.
setMimeType(mimeType)TextOutputتتيح هذه السياسة ضبط نوع MIME للمحتوى الذي سيتم عرضه.

المستندات التفصيلية

append(addedContent)

لإلحاق محتوى جديد بالمحتوى الذي سيتم عرضه

المعلّمات

الاسمالنوعالوصف
addedContentStringالمحتوى المراد إلحاقه

تذكرة ذهاب وعودة

TextOutput — هذا النص الناتج نفسه، مفيد للسلاسل


clear()

يؤدي إلى محو المحتوى الحالي.

تذكرة ذهاب وعودة

TextOutput — هذا النص الناتج نفسه، مفيد للسلاسل


downloadAsFile(filename)

يتم استخدام هذا الإعداد لإبلاغ المتصفّحات بتنزيل المحتوى بدلاً من تنزيله.

ستتجاهل بعض المتصفحات هذا الإعداد. ويؤدي ضبطها على "فارغ" إلى محوها إلى السلوك التلقائي للعرض بدلاً من تنزيلها.

المعلّمات

الاسمالنوعالوصف
filenameStringاسم الملف لإبلاغ المتصفّح باستخدامه

تذكرة ذهاب وعودة

TextOutput: كائن Textإخراج مفيد للسلاسل

طرح

Error — إذا كان اسم الملف يحتوي على أحرف غير قانونية


getContent()

يحصل على المحتوى الذي سيتم عرضه.

تذكرة ذهاب وعودة

String - المحتوى الذي سيتم عرضه


getFileName()

عرض اسم الملف لتنزيل هذا الملف بتنسيق ، أو تركه فارغًا إذا كان يجب عرضه بدلاً من تنزيله.

تذكرة ذهاب وعودة

String — اسم الملف


getMimeType()

حدِّد نوع بروتوكول MIME لهذا المحتوى.

تذكرة ذهاب وعودة

MimeType - نوع بروتوكول MIME الذي سيتم استخدامه مع


setContent(content)

ضبط المحتوى الذي سيتم عرضه.

المعلّمات

الاسمالنوعالوصف
contentStringالمحتوى المراد عرضه

تذكرة ذهاب وعودة

TextOutput — هذا النص الناتج نفسه، مفيد للسلاسل


setMimeType(mimeType)

تتيح هذه السياسة ضبط نوع MIME للمحتوى الذي سيتم عرضه. الإعداد التلقائي هو النص العادي.

المعلّمات

الاسمالنوعالوصف
mimeTypeMimeTypeنوع MIME

تذكرة ذهاب وعودة

TextOutput — هذا النص الناتج نفسه، مفيد للسلاسل