File: xdmthSetNamedNodeProperty_HV01103986.htm

package info (click to toggle)
office2003-schemas 1.0%2Bds-1
  • links: PTS, VCS
  • area: non-free
  • in suites: bookworm, forky, sid, trixie
  • size: 42,304 kB
  • sloc: javascript: 2,429; makefile: 29
file content (33 lines) | stat: -rw-r--r-- 4,520 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
<html dir="ltr"><head>
<META http-equiv="Content-Type" content="text/html; charset=UTF-8">
<META HTTP-EQUIV="assetid" CONTENT="HV01103986"><META NAME="lcid" CONTENT="1033"><title>SetNamedNodeProperty Method</title><link rel="stylesheet" type="text/css" href="office10.css"><script type="text/javascript" language="Javascript" src="ExpCollapse.js"></script><script type="text/javascript" language="JavaScript" src="inline.js"></script></head><body><h1>SetNamedNodeProperty Method</h1><DIV class="ofvbanav"><span class="ofvbanavreuse" id="seealso" onclick="toggleList()" onkeypress="toggleList()"></span><span class="ofvbanavreuse" id="appliesto" onclick="toggleList()" onkeypress="toggleList()"></span><a class="ofvbanavex" href="#example"><span class="ofvbanavreuse" id="example"></span></a><span class="ofvbanavreuse" id="specifics" onclick="toggleList()" onkeypress="toggleList()"></span></DIV><p>
      <p>Sets the value of a named property for the supplied XML node, which must be a nonattribute node in the main data source.</p>
      
        <p class="signature"><i>expression</i>.<b class="bterm">SetNamedNodeProperty</b>(ByVal <b class="bterm"><i>pxmlMainDOMNode</i></b> As IXMLDOMNode, ByVal <b class="bterm"><i>bstrPropertyName</i></b> As String, ByVal <b class="bterm"><i>bstrValue</i></b> As String)</p>
        <p><i>expression   </i> Required. An expression that returns a reference to an <a href="xdobjXDocument.htm" id="HV01021254" lcid=" "><b class="bterm">XDocument</b></a> object.</p><p>
          
            <i><b class="bterm">pxmlMainDOMNode</b>   </i>
          Required <b class="bterm">IXMLDOMNode</b>. An XML node corresponding to a nonattribute node in the main data source, for which a named property is to be set.</p>
        <p>
          
            <i><b class="bterm">bstrPropertyName</b>   </i>
          Required <b class="bterm">String</b>. Specifies the name of the property being set.</p>
        <p>
          
            <i><b class="bterm">bstrValue</b>   </i>
          Required <b class="bterm">String</b>. Specifies the value to which the property will be set.</p>
      
    </p><h2>Security Level</h2><p>2: Can be accessed only by forms running in the same domain as the currently open form, or by forms that have been granted cross-domain permissions.</p><h2>Remarks</h2><p>
      <p>Named properties allow users to associate strings with user-defined properties of XML element nodes in the main data source. The value of a named property can be set by using the <b class="bterm">SetNamedNodeProperty</b> method. Use the <a href="xdmthGetNamedNodeProperty_HV01103978.htm" id="HV01103978" lcid=" "><b class="bterm">GetNamedNodeProperty</b></a> method to read the value of a named property.</p>
    <p><p><b>Note</b>  This object model member is not supported when the <b class="ui">Disable Service Pack features</b> option on the <b class="ui">Advanced</b> tab of the <b class="ui">Options</b> dialog box in InfoPath is selected or when Microsoft Office 2003 Service Pack 1 or later is not installed. Any form that implements this object model member in its code will generate an error message if it is opened in InfoPath when service pack features are disabled or unavailable.</p></p></p><h2><a id="#example" name="#example">Example</a></h2><p>
      <p>In the following example, the value of a named property (with the name "cost") of an XML node (called "item") is set by using the <b class="bterm">SetNamedNodeProperty</b> method:</p>
      <pre><code>var objXMLNode = XDocument.DOM.selectSingleNode("/items/item");
XDocument.<b class="bterm">SetNamedNodeProperty</b>(objXMLNode, 'cost', '100');
var strTest = XDocument.GetNamedNodeProperty(myNode, 'cost', 'empty');</code></pre>
    </p><script type="text/javascript" language="JScript" src="ofvbanl.js"></script><span id="ofVBAISpan" class="ofvbaispan"><iframe id="ofVBAIFrame" frameborder="0" marginheight="0" marginwidth="4" scrolling="auto" width="100%" src="../links/xdmthSetNamedNodeProperty_HV01103986_l.htm"></iframe></span><center><a href="XMLSchemaCopyright_HV01147162.htm">&copy;2003-2004 Microsoft Corporation. All rights reserved.</a>  

Permission to copy, display and distribute this document is available at: <a 

href="http://r.office.microsoft.com/r/rlidAWSContentRedir?AssetID=XT010988631033&amp;CTT=11&amp;Origin=HV011232471033" 

target="_new">http://msdn.microsoft.com/library/en-us/odcXMLRef/html/odcXMLRefLegalNotice.asp</a></center></body></html>