Legacy Documentation: Version 4.6(go to latest)
Language: English
  • C#
  • JS
  • Boo

Script language

Select your preferred scripting language. All code snippets will be displayed in this language.

Component.GetComponent

public Component GetComponent(Type type);

Parameters

type The type of Component to retrieve.

Description

Returns the component of Type type if the game object has one attached, null if it doesn't.

using UnityEngine;
using System.Collections;

public class ExampleClass : MonoBehaviour {
    public HingeJoint hinge;
    void Example() {
        hinge = GetComponent<HingeJoint>();
        hinge.useSpring = false;
    }
}
public T GetComponent();

Description

Generic version. See the Generic Functions page for more details.

public Component GetComponent(string type);

Description

Returns the component with name type if the game object has one attached, null if it doesn't.

It is better to use GetComponent with a Type instead of a string for performance reasons. Sometimes you might not be able to get to the type however, for example when trying to access a C# script from Javascript. In that case you can simply access the component by name instead of type. Example:

using UnityEngine;
using System.Collections;

public class ExampleClass : MonoBehaviour {
    public HingeJoint hinge;
    void Example() {
        hinge = GetComponent("HingeJoint") as HingeJoint;
        hinge.useSpring = false;
    }
}