include(module,namespace = None,app_name = None)[source]
include(pattern_list)
include((pattern_list,app_namespace),namespace = None)
include((pattern_list,app_namespace,instance_namespace))
一个函数,它将完整的Python导入路径带到另一个URLconf模块,该模块应该“包含”在这个地方。可选地,还可以指定将包括条目的应用程序命名空间和实例命名空间。
通常,应用程序命名空间应由包含的模块指定。如果设置了应用程序命名空间,则该namespace参数可用于设置不同的实例命名空间。
include() 还接受返回URL模式的iterable,包含此类iterable的2元组加上应用程序命名空间的名称,或包含iterable的3元组以及应用程序和实例命名空间的名称作为参数。
参数:
- module - URLconf模块(或模块名称)
- namespace(str) - 包含的URL条目的实例名称空间
- app_name(str) - 包含的URL条目的应用程序命名空间
- pattern_list - 可重复django.conf.urls.url()实例
- app_namespace(str) - 包含的URL条目的应用程序名称空间
- instance_namespace(str) - 包含的URL条目的实例名称空间
从版本1.9开始
app_name不推荐使用:不推荐使用对该参数的支持,将在Django 2.0中删除。指定URL名称空间中的app_name说明, 并包含URLconf。
对于传递3元组的支持也已弃用,将在Django 2.0中删除。传递包含模式列表和应用程序命名空间的2元组,并namespace改为使用参数。
最后,对不带应用程序命名空间的实例命名空间的支持已被弃用,并将在Django 2.0中删除。指定应用程序命名空间或删除实例命名空间。