Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

String Constructor (Char*, Int32, Int32)

Initializes a new instance of the String class to the value indicated by a specified pointer to an array of Unicode characters, a starting character position within that array, and a length.

This API is not CLS-compliant. 

Namespace:  System
Assembly:  mscorlib (in mscorlib.dll)

[CLSCompliantAttribute(false)]
public String(
	char* value,
	int startIndex,
	int length
)

Parameters

value
Type: System.Char*

A pointer to an array of Unicode characters.

startIndex
Type: System.Int32

The starting position within value.

length
Type: System.Int32

The number of characters within value to use.

ExceptionCondition
ArgumentOutOfRangeException

startIndex or length is less than zero, value + startIndex cause a pointer overflow, or the current process does not have read access to all the addressed characters.

ArgumentException

value specifies an array that contains an invalid Unicode character, or value + startIndex specifies an address less than 64000.

NoteNote

For examples and comprehensive usage information about this and other String constructor overloads, see the String constructor summary.

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5, 3.0, 2.0, 1.1

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

XNA Framework

Supported in: 3.0, 2.0, 1.0

Portable Class Library

Supported in: Portable Class Library

Supported in: Windows Phone 8.1

Supported in: Windows Phone Silverlight 8.1

Supported in: Windows Phone Silverlight 8

  • SecurityCriticalAttribute 

    requires full trust for the immediate caller. This member cannot be used by partially trusted or transparent code.

Show:
© 2015 Microsoft