Documentation

Unity Engine

User Manual

Script Reference

Unity Engine

Put

Creates a UnityWebRequest configured to upload raw data to a remote server via HTTP PUT.
Read time 5 minutesLast updated 6 days ago

Definition

Put(string, byte[])

Creates a UnityWebRequest configured to upload raw data to a remote server via HTTP PUT.
public static UnityWebRequest Put(string uri, byte[] bodyData)

Parameters

uri

string
The URI to which the data will be sent.

bodyData

byte[]
The data to transmit to the remote server.
If a string, the string will be converted to raw bytes via System.Text.Encoding.UTF8.

Returns

Type

Description

UnityWebRequestA UnityWebRequest configured to transmit 
bodyData
to 
uri
via HTTP PUT.

Remarks

This method creates a UnityWebRequest, sets the target URL to the string 
uri
argument and the 
method
to 
PUT
. It also sets the 
Content-Type
header to 
application/octet-stream
.
This method attaches a standard DownloadHandlerBuffer to the UnityWebRequest. This is for convenience during development, as well as for applications which return status information regarding the uploaded data in the HTTP response body.
This method stores the input upload data in an UploadHandlerRaw object and attaches it to the UnityWebRequest. UploadHandlerRaw copies the input data into a buffer. Therefore, changes to the 
bodyData
array performed after the call to this method will not be reflected in the data sent to the server.

Examples

using UnityEngine;using UnityEngine.Networking;using System.Collections;public class MyBehavior : MonoBehaviour{    void Start()    {        StartCoroutine(Upload());    }    IEnumerator Upload()    {        byte[] myData = System.Text.Encoding.UTF8.GetBytes("This is some test data");        using (UnityWebRequest www = UnityWebRequest.Put("https://www.my-server.com/upload", myData))        {            yield return www.SendWebRequest();            if (www.result != UnityWebRequest.Result.Success)            {                Debug.Log(www.error);            }            else            {                Debug.Log("Upload complete!");            }        }    }}

Put(Uri, byte[])

Creates a UnityWebRequest configured to upload raw data to a remote server via HTTP PUT.
public static UnityWebRequest Put(Uri uri, byte[] bodyData)

Parameters

uri

Uri
The URI to which the data will be sent.

bodyData

byte[]
The data to transmit to the remote server.
If a string, the string will be converted to raw bytes via System.Text.Encoding.UTF8.

Returns

Type

Description

UnityWebRequestA UnityWebRequest configured to transmit 
bodyData
to 
uri
via HTTP PUT.

Remarks

This method creates a UnityWebRequest, sets the target URL to the string 
uri
argument and the 
method
to 
PUT
. It also sets the 
Content-Type
header to 
application/octet-stream
.
This method attaches a standard DownloadHandlerBuffer to the UnityWebRequest. This is for convenience during development, as well as for applications which return status information regarding the uploaded data in the HTTP response body.
This method stores the input upload data in an UploadHandlerRaw object and attaches it to the UnityWebRequest. UploadHandlerRaw copies the input data into a buffer. Therefore, changes to the 
bodyData
array performed after the call to this method will not be reflected in the data sent to the server.

Examples

using UnityEngine;using UnityEngine.Networking;using System.Collections;public class MyBehavior : MonoBehaviour{    void Start()    {        StartCoroutine(Upload());    }    IEnumerator Upload()    {        byte[] myData = System.Text.Encoding.UTF8.GetBytes("This is some test data");        using (UnityWebRequest www = UnityWebRequest.Put("https://www.my-server.com/upload", myData))        {            yield return www.SendWebRequest();            if (www.result != UnityWebRequest.Result.Success)            {                Debug.Log(www.error);            }            else            {                Debug.Log("Upload complete!");            }        }    }}

Put(string, string)

Creates a UnityWebRequest configured to upload raw data to a remote server via HTTP PUT.
public static UnityWebRequest Put(string uri, string bodyData)

Parameters

uri

string
The URI to which the data will be sent.

bodyData

string
The data to transmit to the remote server.
If a string, the string will be converted to raw bytes via System.Text.Encoding.UTF8.

Returns

Type

Description

UnityWebRequestA UnityWebRequest configured to transmit 
bodyData
to 
uri
via HTTP PUT.

Remarks

This method creates a UnityWebRequest, sets the target URL to the string 
uri
argument and the 
method
to 
PUT
. It also sets the 
Content-Type
header to 
application/octet-stream
.
This method attaches a standard DownloadHandlerBuffer to the UnityWebRequest. This is for convenience during development, as well as for applications which return status information regarding the uploaded data in the HTTP response body.
This method stores the input upload data in an UploadHandlerRaw object and attaches it to the UnityWebRequest. UploadHandlerRaw copies the input data into a buffer. Therefore, changes to the 
bodyData
array performed after the call to this method will not be reflected in the data sent to the server.

Examples

using UnityEngine;using UnityEngine.Networking;using System.Collections;public class MyBehavior : MonoBehaviour{    void Start()    {        StartCoroutine(Upload());    }    IEnumerator Upload()    {        byte[] myData = System.Text.Encoding.UTF8.GetBytes("This is some test data");        using (UnityWebRequest www = UnityWebRequest.Put("https://www.my-server.com/upload", myData))        {            yield return www.SendWebRequest();            if (www.result != UnityWebRequest.Result.Success)            {                Debug.Log(www.error);            }            else            {                Debug.Log("Upload complete!");            }        }    }}

Put(Uri, string)

Creates a UnityWebRequest configured to upload raw data to a remote server via HTTP PUT.
public static UnityWebRequest Put(Uri uri, string bodyData)

Parameters

uri

Uri
The URI to which the data will be sent.

bodyData

string
The data to transmit to the remote server.
If a string, the string will be converted to raw bytes via System.Text.Encoding.UTF8.

Returns

Type

Description

UnityWebRequestA UnityWebRequest configured to transmit 
bodyData
to 
uri
via HTTP PUT.

Remarks

This method creates a UnityWebRequest, sets the target URL to the string 
uri
argument and the 
method
to 
PUT
. It also sets the 
Content-Type
header to 
application/octet-stream
.
This method attaches a standard DownloadHandlerBuffer to the UnityWebRequest. This is for convenience during development, as well as for applications which return status information regarding the uploaded data in the HTTP response body.
This method stores the input upload data in an UploadHandlerRaw object and attaches it to the UnityWebRequest. UploadHandlerRaw copies the input data into a buffer. Therefore, changes to the 
bodyData
array performed after the call to this method will not be reflected in the data sent to the server.

Examples

using UnityEngine;using UnityEngine.Networking;using System.Collections;public class MyBehavior : MonoBehaviour{    void Start()    {        StartCoroutine(Upload());    }    IEnumerator Upload()    {        byte[] myData = System.Text.Encoding.UTF8.GetBytes("This is some test data");        using (UnityWebRequest www = UnityWebRequest.Put("https://www.my-server.com/upload", myData))        {            yield return www.SendWebRequest();            if (www.result != UnityWebRequest.Result.Success)            {                Debug.Log(www.error);            }            else            {                Debug.Log("Upload complete!");            }        }    }}