Class TextOutput

TextOutput

كائن TextOutput يمكن عرضه من نص برمجي

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

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

function doGet() {
  return ContentService.createTextOutput('hello world!');
}

تتوفّر أيضًا طرق لعرض JSON وRSS وXML كـ TextOutputs، يمكنك الاطّلاع على الطرق المقابلة على ContentService.

الطُرق

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

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

append(addedContent)

تضيف هذه السمة محتوًى جديدًا إلى المحتوى الذي سيتم عرضه.

المَعلمات

الاسم	النوع	الوصف
addedContent	String	المحتوى الذي سيتم إلحاقه

الإرجاع

‫TextOutput: يمثّل هذا النص الناتج نفسه، وهو مفيد في الربط بين العمليات

---

clear()

يمحو هذا الزر المحتوى الحالي.

الإرجاع

‫TextOutput: يمثّل هذا النص الناتج نفسه، وهو مفيد في الربط بين العمليات

---

downloadAsFile(filename)

يطلب من المتصفحات تنزيل هذا المحتوى بدلاً من عرضه.

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

المَعلمات

الاسم	النوع	الوصف
filename	String	اسم الملف الذي يجب إعلام المتصفّح باستخدامه

الإرجاع

‫TextOutput: كائن TextOutput، وهو مفيد للتسلسل

عمليات الطرح

Error: إذا كان اسم الملف يحتوي على أحرف غير مسموح بها

---

getContent()

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

الإرجاع

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

---

getFileName()

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

الإرجاع

String: اسم الملف

---

getMimeType()

الحصول على نوع MIME الذي سيتم عرض هذا المحتوى به

الإرجاع

‫MimeType: نوع MIME الذي سيتم عرضه به

---

setContent(content)

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

المَعلمات

الاسم	النوع	الوصف
content	String	المحتوى المطلوب عرضه

الإرجاع

‫TextOutput: يمثّل هذا النص الناتج نفسه، وهو مفيد في الربط بين العمليات

---

setMimeType(mimeType)

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

المَعلمات

الاسم	النوع	الوصف
mimeType	MimeType	نوع MIME

الإرجاع

‫TextOutput: يمثّل هذا النص الناتج نفسه، وهو مفيد في الربط بين العمليات