次の方法で共有


IXMLReader.GetFeature(String) Method

Definition

Look up the value of a feature flag.

[Android.Runtime.Register("getFeature", "(Ljava/lang/String;)Z", "GetGetFeature_Ljava_lang_String_Handler:Org.Xml.Sax.IXMLReaderInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null")]
public bool GetFeature (string? name);
[<Android.Runtime.Register("getFeature", "(Ljava/lang/String;)Z", "GetGetFeature_Ljava_lang_String_Handler:Org.Xml.Sax.IXMLReaderInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null")>]
abstract member GetFeature : string -> bool

Parameters

name
String

The feature name, which is a fully-qualified URI.

Returns

The current value of the feature (true or false).

Attributes

Exceptions

If the feature value can't be assigned or retrieved.

When the XMLReader recognizes the feature name but cannot determine its value at this time.

Remarks

Look up the value of a feature flag.

The feature name is any fully-qualified URI. It is possible for an XMLReader to recognize a feature name but temporarily be unable to return its value. Some feature values may be available only in specific contexts, such as before, during, or after a parse. Also, some feature values may not be programmatically accessible. (In the case of an adapter for SAX1 Parser, there is no implementation-independent way to expose whether the underlying parser is performing validation, expanding external entities, and so forth.)

All XMLReaders are required to recognize the http://xml.org/sax/features/namespaces and the http://xml.org/sax/features/namespace-prefixes feature names.

Typical usage is something like this:

XMLReader r = new MySAXDriver();

                                    // try to activate validation
            try {
              r.setFeature("http://xml.org/sax/features/validation", true);
            } catch (SAXException e) {
              System.err.println("Cannot activate validation.");
            }

                                    // register event handlers
            r.setContentHandler(new MyContentHandler());
            r.setErrorHandler(new MyErrorHandler());

                                    // parse the first document
            try {
              r.parse("http://www.foo.com/mydoc.xml");
            } catch (IOException e) {
              System.err.println("I/O exception reading XML document");
            } catch (SAXException e) {
              System.err.println("XML exception reading document.");
            }

Implementors are free (and encouraged) to invent their own features, using names built on their own URIs.

Java documentation for org.xml.sax.XMLReader.getFeature(java.lang.String).

Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.

Applies to

See also

  • <xref:Org.Xml.Sax.IXMLReader.SetFeature(System.String%2c+System.Boolean)>