ScriptingJsonSerializationSection 類別

定義

命名空間:

System.Web.Configuration

組件:

System.Web.Extensions.dll

代表 jsonSerialization 設定檔元素中的 scripting 一個設定區段。 此類別無法獲得繼承。

public ref class ScriptingJsonSerializationSection sealed : System::Configuration::ConfigurationSection

public sealed class ScriptingJsonSerializationSection : System.Configuration.ConfigurationSection

type ScriptingJsonSerializationSection = class
    inherit ConfigurationSection

Public NotInheritable Class ScriptingJsonSerializationSection
Inherits ConfigurationSection

繼承

Object

ConfigurationElement

ConfigurationSection

ScriptingJsonSerializationSection

範例

以下設定檔摘錄展示了如何宣告式地指定類別屬性 ScriptingJsonSerializationSection 的值。

<system.web.extensions>
  <scripting>
    <webServices>
      <jsonSerialization maxJsonLength="1000" />
    </webServices>
  </scripting>
</system.web.extensions>

以下範例示範如何以程式化方式存取 ScriptingJsonSerializationSection 。

// Get the Web application configuration.
System.Configuration.Configuration configuration =
    WebConfigurationManager.OpenWebConfiguration("/aspnetTest");

// Get the external JSON section.
ScriptingJsonSerializationSection jsonSection =
    (ScriptingJsonSerializationSection)configuration.GetSection(
    "system.web.extensions/scripting/webServices/jsonSerialization");

//Get the converters collection.
ConvertersCollection converters =
    jsonSection.Converters;

if ((converters != null) && converters.Count > 0)
{
    // Get the first registered converter.
    Converter converterElement = converters[0];
}

' Get the Web application configuration.
Dim configuration As System.Configuration.Configuration = _
    WebConfigurationManager.OpenWebConfiguration("/aspnetTest")

' Get the external JSON section.
Dim jsonSection As ScriptingJsonSerializationSection = _
    CType(configuration.GetSection( _
        "system.web.extensions/scripting/webServices/jsonSerialization"), _
        ScriptingJsonSerializationSection)

'Get the converters collection.
Dim converters As ConvertersCollection = _
    jsonSection.Converters

If Not (converters Is Nothing) AndAlso _
    converters.Count > 0 Then
    ' Get the first registered converter.
    Dim converterElement As Converter = converters(0)
End If

備註

這個 ScriptingJsonSerializationSection 類別讓你能程式化地存取並修改 jsonSerialization 設定區塊的元素，以便在 ASP.NET 中使用 AJAX 功能。

使用此類型可設定支援 AJAX 應用程式的序列化與反序列化設定值。

建構函式

名稱	Description
ScriptingJsonSerializationSection()	初始化 ScriptingJsonSerializationSection 類別的新執行個體。

屬性

名稱	Description
Converters	取得 ConvertersCollection 包含一組 Converter 物件的物件。
CurrentConfiguration	取得最上層 Configuration 實例的參考，表示目前 ConfigurationElement 實例所屬的組態階層。 (繼承來源 ConfigurationElement)
ElementInformation	取得 ElementInformation 物件，其中包含 ConfigurationElement 物件的不可自定義資訊和功能。 (繼承來源 ConfigurationElement)
ElementProperty	取得代表 ConfigurationElementProperty 物件本身的 ConfigurationElement 物件。 (繼承來源 ConfigurationElement)
EvaluationContext	取得 ContextInformation 物件的 ConfigurationElement 物件。 (繼承來源 ConfigurationElement)
HasContext	取得值，這個值表示 CurrentConfiguration 屬性是否 null。 (繼承來源 ConfigurationElement)
Item[ConfigurationProperty]	取得或設定這個組態項目的屬性或屬性。 (繼承來源 ConfigurationElement)
Item[String]	取得或設定這個組態專案的屬性、屬性或子專案。 (繼承來源 ConfigurationElement)
LockAllAttributesExcept	取得鎖定屬性的集合。 (繼承來源 ConfigurationElement)
LockAllElementsExcept	取得鎖定專案的集合。 (繼承來源 ConfigurationElement)
LockAttributes	取得鎖定屬性的集合。 (繼承來源 ConfigurationElement)
LockElements	取得鎖定專案的集合。 (繼承來源 ConfigurationElement)
LockItem	取得或設定值，指出專案是否已鎖定。 (繼承來源 ConfigurationElement)
MaxJsonLength	取得或設定物件可接受 JavaScriptSerializer 的最大長度，適用於 JavaScript 物件符號（JSON）字串。
Properties	取得屬性的集合。 (繼承來源 ConfigurationElement)
RecursionLimit	取得或設定限制處理物件層級數量的限制。
SectionInformation	取得 SectionInformation 一個包含該物件不可自訂資訊與功能的 ConfigurationSection 物件。 (繼承來源 ConfigurationSection)

方法

名稱	Description
DeserializeElement(XmlReader, Boolean)	從組態檔讀取 XML。 (繼承來源 ConfigurationElement)
DeserializeSection(XmlReader)	從組態檔讀取 XML。 (繼承來源 ConfigurationSection)
Equals(Object)	將目前 ConfigurationElement 實例與指定的物件進行比較。 (繼承來源 ConfigurationElement)
GetHashCode()	會獲得代表當前 ConfigurationElement 實例的唯一值。 (繼承來源 ConfigurationElement)
GetRuntimeObject()	在衍生類別中覆寫時，會回傳一個自訂物件。 (繼承來源 ConfigurationSection)
GetTransformedAssemblyString(String)	傳回所指定元件名稱的轉換版本。 (繼承來源 ConfigurationElement)
GetTransformedTypeString(String)	傳回指定之型別名稱的轉換版本。 (繼承來源 ConfigurationElement)
GetType()	取得目前實例的 Type。 (繼承來源 Object)
Init()	將 ConfigurationElement 物件設定為其初始狀態。 (繼承來源 ConfigurationElement)
InitializeDefault()	用來初始化 ConfigurationElement 物件的預設值集。 (繼承來源 ConfigurationElement)
IsModified()	表示此組態元素自最後儲存或載入後是否被修改，且在衍生類別中實作。 (繼承來源 ConfigurationSection)
IsReadOnly()	會取得一個值，表示該物件是否 ConfigurationElement 為唯讀。 (繼承來源 ConfigurationElement)
ListErrors(IList)	將這個 ConfigurationElement 物件和所有子元素中的無效屬性錯誤新增至傳遞的清單。 (繼承來源 ConfigurationElement)
MemberwiseClone()	建立目前 Object的淺層複本。 (繼承來源 Object)
OnDeserializeUnrecognizedAttribute(String, String)	取得值，指出還原串行化期間是否遇到未知的屬性。 (繼承來源 ConfigurationElement)
OnDeserializeUnrecognizedElement(String, XmlReader)	會獲得一個值，表示在反序列化過程中是否遇到未知元素。 (繼承來源 ConfigurationElement)
OnRequiredPropertyNotFound(String)	找不到必要屬性時擲回例外狀況。 (繼承來源 ConfigurationElement)
PostDeserialize()	在還原串行化之後呼叫。 (繼承來源 ConfigurationElement)
PreSerialize(XmlWriter)	在串行化之前呼叫。 (繼承來源 ConfigurationElement)
Reset(ConfigurationElement)	重置物件的 ConfigurationElement 內部狀態，包括鎖與屬性集合。 (繼承來源 ConfigurationElement)
ResetModified()	在導出類別實作時，將方法的值IsModified()重置為 。false (繼承來源 ConfigurationSection)
SerializeElement(XmlWriter, Boolean)	當在衍生類別中實作時，會將此組態元素的內容寫入設定檔。 (繼承來源 ConfigurationElement)
SerializeSection(ConfigurationElement, String, ConfigurationSaveMode)	建立一個包含物件未合併視圖 ConfigurationSection 的 XML 字串，作為一個區段來寫入檔案。 (繼承來源 ConfigurationSection)
SerializeToXmlElement(XmlWriter, String)	在衍生類別中實作時，將此組態專案的外部標記寫入組態檔。 (繼承來源 ConfigurationElement)
SetPropertyValue(ConfigurationProperty, Object, Boolean)	將屬性設定為指定的值。 (繼承來源 ConfigurationElement)
SetReadOnly()	設定 IsReadOnly() 物件及所有子元素的 ConfigurationElement 屬性。 (繼承來源 ConfigurationElement)
ShouldSerializeElementInTargetVersion(ConfigurationElement, String, FrameworkName)	表示當設定物件階層序列化至指定目標版本的 .NET 框架時，是否應序列化該元素。 (繼承來源 ConfigurationSection)
ShouldSerializePropertyInTargetVersion(ConfigurationProperty, String, FrameworkName, ConfigurationElement)	指示當設定物件階層序列化至指定版本的 .NET 框架時，是否應序列化該屬性。 (繼承來源 ConfigurationSection)
ShouldSerializeSectionInTargetVersion(FrameworkName)	指示當前ConfigurationSection實例是否應該序列化，當配置物件階層序列化以符合指定目標版本.NET框架時。 (繼承來源 ConfigurationSection)
ToString()	傳回表示目前 物件的字串。 (繼承來源 Object)
Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode)	修改物件 ConfigurationElement 以移除所有不應儲存的值。 (繼承來源 ConfigurationElement)

另請參閱

• ConfigurationSection
• 如何：在 ASP.NET AJAX