GlobalConfig.MakeStringFromArray Method (PIA)
Use this method to convert a System.Array object into an encoded String, which can be written to the Fields property.
Definition
[Visual Basic .NET]
Imports Microsoft.CommerceServer.Interop.Configuration
…
Public Function MakeStringFromArray(ByRefvarArray As Object) As Object
[C#]
using Microsoft.CommerceServer.Interop.Configuration;
…
public object MakeStringFromArray(ref objectvarArray);
Parameters
[Visual Basic .NET]
- varArray
An Object that contains the System.Array object to encode.
[C#]
- varArray
An object that contains the System.Array object to encode.
Return Values
[Visual Basic .NET] If this method completes successfully, it returns an Object that contains the encoded String.
[C#] This method returns an object containing the encoded string.
Exceptions
This method may throw one of many mapped exceptions or an exception of type COMException. See Standard COM Errors for additional details.
Remarks
The Initialize method must be called before this method can be called.
****Important
- There is a special group of methods used with multi-valued arrays. These methods are the only approved and recommended way of storing and retrieving multi-valued arrays in the Administration database. You must use the following methods with any property that has the structure of a multi-valued array:
- MakeArrayFromSimpleList
- MakeSimpleListFromArray
- MakeArrayFromString
- MakeStringFromArray
Note
- This method can only be used when updating values exposed by the Fields object. The client-side disconnected ADO recordset has no support for Objects or System.Arrays as Fields columns. Therefore, the GlobalConfig object resorts to storing data in an encoded String format.
[Visual Basic .NET]
Example
' oEncoded is an Object
' oArray is an Object
' oGlobalConfig is a Commerce GlobalConfig object
oEncoded = oGlobalConfig.MakeStringFromArray(oArray)
Requirements
Namespace: Microsoft.CommerceServer.Interop.Configuration
Platforms: Windows 2000, Windows Server 2003
Assembly: cs_mscscfg (in cs_mscscfg.dll)
See Also
Copyright © 2005 Microsoft Corporation.
All rights reserved.